The LifeOmic Platform is an API-first design. You can use the LifeOmic API to programmatically control all of the features of the platform. This public API powers all of the LifeOmic client applications, including the LifeOmic mobile app and the LifeOmic Platform web application.
You can build your own third-party applications around the LifeOmic health-focused APIs in the same manner that you can build a communication app around Twilio APIs. LifeOmic has helped several customers use the LifeOmic API as a Platform as a Service (PaaS). Contact LifeOmic to set up credentials for your app.
The simplest way for a developer to make API calls is to use an API key. See the Getting Started Guide for instructions on how to create an API key. After creating an API key, it can be provided via the Authorization
HTTP header in the same fashion as the access tokens.
Visit the Developer Center for more information on the LifeOmic API:
For the authorization code flow, this allows a client to exchange an authorization code for an access token. This operation does not require authentication.
Authorization required | string If the client was issued a secret, the client must pass its client_id and client_secret in the authorization header through Basic HTTP authorization. The secret is |
grant_type required | string Enum: "authorization_code" "refresh_token" The grant type. |
client_id required | string The client ID. Must be a preregistered client. |
code | string The authorization code. Required if |
redirect_uri | string Must be the same redirect_uri that was used to get |
refresh_token | string The refresh token. Required if |
code_verifier | string The proof key. Required if |
# You can also use wget curl -X POST https://api.us.lifeomic.com/v1/oauth/token \ -H 'Content-Type: application/x-www-form-urlencoded' \ -H 'Accept: application/json' \ -H 'Authorization: string'
{- "access_token": "string",
- "refresh_token": "string",
- "id_token": "string",
- "token_type": "string",
- "expires_in": 0
}
Supports operations for a subset of patients from a LifeOmic Platform project.
To learn about the service as implemented in the LifeOmic Platform web app, see the Cohorts Overview.
Returns a list of cohorts that the user has access to.
projectId required | string The ID of the project to search within for cohorts. |
name | string Only return cohorts that have a name that starts with the given value. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "name": "string",
- "description": "string",
- "ownerProject": "string",
- "resultCount": 0,
- "creatorUser": "string",
- "creationTime": "string",
- "queries": [
- {
- "project": "string",
- "queryType": "string",
- "query": { }
}
]
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Create a cohort, representing a subset of a project based on one or more queries
LifeOmic-Account required | string The LifeOmic account to access. |
name required | string |
description | string |
ownerProject required | string |
required | Array of objects (CohortQuery) |
{- "name": "string",
- "description": "string",
- "ownerProject": "string",
- "queries": [
- {
- "project": "string",
- "queryType": "string",
- "query": { }
}
]
}
{- "name": "string",
- "description": "string",
- "ownerProject": "string",
- "resultCount": 0,
- "creatorUser": "string",
- "creationTime": "string",
- "queries": [
- {
- "project": "string",
- "queryType": "string",
- "query": { }
}
]
}
Returns a cohort.
cohortId required | string The cohort id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "name": "string",
- "description": "string",
- "ownerProject": "string",
- "resultCount": 0,
- "creatorUser": "string",
- "creationTime": "string",
- "queries": [
- {
- "project": "string",
- "queryType": "string",
- "query": { }
}
]
}
Returns the updated cohort.
cohortId required | string The cohort id. |
LifeOmic-Account required | string The LifeOmic account to access. |
name required | string |
description | string |
ownerProject required | string |
required | Array of objects (CohortQuery) |
{- "name": "string",
- "description": "string",
- "ownerProject": "string",
- "queries": [
- {
- "project": "string",
- "queryType": "string",
- "query": { }
}
]
}
{- "name": "string",
- "description": "string",
- "ownerProject": "string",
- "resultCount": 0,
- "creatorUser": "string",
- "creationTime": "string",
- "queries": [
- {
- "project": "string",
- "queryType": "string",
- "query": { }
}
]
}
Supports Content Entity operations on the LifeOmic Platform
Content Entity operations take place on https://apps.us.lifeomic.com/api/v2/content.
Returns the entity object.
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "entityId": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "scope": "account",
- "displayName": "string",
- "contentType": "audio",
- "lastModified": "2019-08-24T14:15:22Z",
- "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9",
}
Creates an entity, returning the entity object.
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "entityId": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "scope": "account",
- "displayName": "string",
- "contentType": "audio",
- "lastModified": "2019-08-24T14:15:22Z",
- "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9",
}
Updates an entity, returning the entity object.
entityId required | string The entityId. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "entityId": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "scope": "account",
- "displayName": "string",
- "contentType": "audio",
- "lastModified": "2019-08-24T14:15:22Z",
- "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9",
}
Delete an entity.
entityId required | string The entityId. |
hard | boolean Default: false Force hard delete |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
[- {
- "id": "string",
- "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9",
- "scope": "account",
- "displayName": "string",
- "contentType": "audio",
- "sortName": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
]
Get an acl.
type required | string Enum: "owner" "shared" "view" The acl type |
entityId required | string The entityId. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "username_entityId": "string",
- "entityId": "string",
- "type": "owner"
}
Returns the entity object.
project required | string The LifeOmic project. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "items": [
- {
- "entityId": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "scope": "account",
- "displayName": "string",
- "contentType": "audio",
- "lastModified": "2019-08-24T14:15:22Z",
- "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9",
}
]
}
Returns the entity objects.
project required | string The LifeOmic project. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "items": [
- {
- "entityId": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "scope": "account",
- "displayName": "string",
- "contentType": "audio",
- "lastModified": "2019-08-24T14:15:22Z",
- "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9",
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates an entity assignment, returning the entity assignment object.
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "id": "string",
- "ownerId": "string",
- "entityId": "string",
- "assigneeLrn": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
Returns the entity assignment object.
assignmentId required | string Content entity assignment identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "id": "string",
- "ownerId": "string",
- "entityId": "string",
- "assigneeLrn": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
Updates an entity assignment, returning the entity assignment object.
assignmentId required | string Content entity assignment identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "id": "string",
- "ownerId": "string",
- "entityId": "string",
- "assigneeLrn": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
Delete an entity assignment.
assignmentId required | string The entity assignment identifier. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "id": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
Returns the entity assignment object.
project required | string The LifeOmic project. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "items": [
- {
- "id": "string",
- "ownerId": "string",
- "entityId": "string",
- "assigneeLrn": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
]
}
Returns the entity assignment object.
project required | string The LifeOmic project. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "items": [
- {
- "id": "string",
- "ownerId": "string",
- "entityId": "string",
- "assigneeLrn": "string",
- "lastModified": "2019-08-24T14:15:22Z"
}
]
}
Starts the process of converting video file to stream format.
entityId required | string The entityId. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{ }
After video conversion has completed then the fetch route is available
project required | string <uuid> The LifeOmic project id. |
serviceId required | string <uuid> The service id returned from CreateEntity. |
LifeOmic-Account required | string The LifeOmic account to access. |
Lifeomic-User required | string The LifeOmic user. |
{- "getVideo": {
- "id": "string",
- "title": "string",
- "description": "string",
- "thumbnails": [ ],
- "duration": 0,
}
}
Supports operations for storing and retrieving course-related and program-related content. For more information, see the Content Service Guide.
Lists the content items for your LifeOmic project.
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
name | string Filters the result set by performing a case-insensitive begins with filter on the file name. |
orderBy | string Enum: "name" "size" Allows one to order the results by file name or by size. Default is to sort by name in ascending order. To sort in descending order, add |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location 'https://api.us.lifeomic.com/v1/content/<projectId>/content' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
{- "items": {
- "id": "f968d237-73c6-46cf-814e-5f040b7af494",
- "project": "ebe1618f-e474-4947-a6d2-18b19fac6xyz",
- "displayName": "Get Eating Healthy",
- "type": "course",
- "fields": {
- "description": {
- "value": "learning about meditation"
}, - "duration": {
- "value": 7
}, - "daySlugs": {
- "value": [
- "390fdc3d-3078-43dd-9387-48caa4978b1e",
- "0660c507-b1a4-4e71-827f-984189d9acc6",
- "2dda07cc-908e-4fb1-a862-fb51b8354e1a",
- "bff73e02-257d-4b37-97fe-b96fbe9103b2",
- "c5532546-aa23-4b8b-b2c9-85ab60826f19",
- "37bab494-b226-4248-8651-f5a58a930091",
- "c3e98713-b2d7-4fb7-9fc0-c1f1e6ec23ff"
]
}, - "isPristine": {
- "value": false
}
}, - "slug": "1defb12c-daae-42f2-b13c-b9d010ef8c45",
- "keyPath": "meditation-program-99823e2d-5cef-4990-af00-f92cafc8fd07/1defb12c-daae-42f2-b13c-b9d010ef8c45",
- "status": "draft",
- "isDirty": true,
- "lastModified": "2022-10-12T19:45:43.795Z",
- "account": "company",
- "links": {
- "self": "/v1/content/ebe1618f-e474-4947-a6d2-18b19fac6xyz/content",
- "next": "/v1/content/ebe1618f-e474-4947-a6d2-18b19fac6xyz/content?nextPageToken=eyJwcm9qZWN0IjoiZWJlMTYxOGYtZTQ3NC00OTQ3LWE2ZDItMThiMTlmYWM2NjNhIiwiaWQiOiJsaWZlb21pYzowNjAwYzNmNC02YTM5LTQ2NjktOGU1MC0zZjMxNDU5NWEzMmQiLCJyb3dUeXBlIjoiY29udGVudDpsaWZlb21pYzowNjAwYzNmNC02YTM5LTQ2NjktOGU1MC0zZjMxNDU5NWEzMmQiLCJ0eXBlIjoicHJvZ3JhbSJ9"
}
}
}
Create a content item. If an id is not supplied by the user, a unique id is assigned with the response. This id is the contentId you need for future operations.
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
id | string (id) Content ID |
project required | string (project) Project with which content is associated |
displayName required | string (displayName) Human readable name for content |
type required | string (type) Type of content |
language | string (language) Primary language for the content |
object (fields) Content fields | |
tags | Array of strings (tags) Descriptive tags for the content |
slug required | string (slug) ^[a-zA-Z0-9-\/]+$ Slug to identify content |
object (meta) Additional data describing the content | |
public | boolean (public) Should the content be made public |
keyPath | string (keyPath) ^(?!\/)[a-z0-9-/]+$ Key path to designate path of nested content |
property name* additional property | any |
{- "id": "string",
- "project": "string",
- "displayName": "string",
- "type": "string",
- "language": "string",
- "fields": {
- "property1": {
- "value": null,
- "property1": null,
- "property2": null
}, - "property2": {
- "value": null,
- "property1": null,
- "property2": null
}
}, - "tags": [
- "string"
], - "slug": "string",
- "meta": { },
- "public": true,
- "keyPath": "string"
}
{- "id": "8256efc4-116f-4063-bd6b-6d63b4ad8b56",
- "project": "<projectId>",
- "displayName": "Test Course",
- "type": "course",
- "slug": "1defb12c-daae-42f2-b13c-b9d010ef8c00",
- "status": "draft",
- "isDirty": true,
- "lastModified": "2023-06-20T14:57:52.066Z",
- "account": "<account-name>",
- "fileAttachments": [ ],
- "contentAttachments": [ ]
}
Lists a specific content item.
contentId required | string Specifies the content item. Found in the list all content response as the |
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location https://api.us.lifeomic.com/v1/content/<projectId>/content/<contentId>' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
{- "id": "<contentId>",
- "project": "<projectId>",
- "displayName": "Test Course",
- "type": "course",
- "fields": {
- "description": {
- "value": "Test course description"
}
}, - "slug": "1defb12c-daae-42f2-b13c-b9d010ef8c99",
- "status": "published",
- "isDirty": false,
- "version": 1687963272285,
- "parentVersion": "1defb12c-daae-42f2-b13c-b9d010ef8c99:1687448761669",
- "lastModified": "2023-06-28T14:41:12.285Z",
- "publishDate": "2023-06-28T14:41:12.285Z",
- "account": "<accountName>",
- "fileAttachments": [
- {
- "contentId": "<contentId>",
- "project": "<projectId>",
- "file": {
- "id": "e0b9e7f4-1474-42d6-b87a-a1e21e015c0c",
- "name": "2dlvXN.png",
- "fileKey": "<fileKey>",
- "account": "<company>",
- "project": "<projectId>",
- "size": 3146174,
- "contentType": "image/png",
- "lastModified": "2023-06-22T16:42:46.199Z",
- "type": "FILE",
- "url": "<publicUrl>",
- "meta": {
- "isDirectory": false,
- "private": false
}, - "lrn": "lrn:<lrnId>"
}, - "meta": { }
}
], - "contentAttachments": [ ]
}
Deletes the content item specified with the content id.
contentId required | string The content item id. |
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location --request DELETE 'https://api.us.lifeomic.com/v1/content/{projectId}/content/{contentId}' \ --header 'LifeOmic-Account: {account-id}' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {api-key}'
null
You demote content from publish state to draft state with this POST call.
contentId required | string Specifies the content item. Found in the list all content response as the |
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location --request POST 'https://api.us.lifeomic.com/v1/content/<projectId>/content/<contentId>/draft' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
{- "id": "contentId",
- "project": "projectId",
- "displayName": "Test Course",
- "type": "course",
- "fields": {
- "description": {
- "value": "Test course description"
}
}, - "slug": "1defb12c-daae-42f2-b13c-b9d010ef8c99",
- "status": "draft",
- "isDirty": false,
- "version": 1687448761669,
- "lastModified": "2023-06-20T14:29:54.662Z",
- "publishDate": "2023-06-22T15:46:01.669Z",
- "account": "account-name"
}
You promote content from draft state to publish state with the POST call. Content is created with a default status of draft.
contentId required | string Specifies the content item. Found in the list all content response as the |
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location --request POST 'https://api.us.lifeomic.com/v1/content/<projectId>/content/<contentId>/publish' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
{- "id": "contentId",
- "project": "projectId",
- "displayName": "Test Course",
- "type": "course",
- "fields": {
- "description": {
- "value": "Test course description"
}
}, - "slug": "1defb12c-daae-42f2-b13c-b9d010ef8c99",
- "status": "published",
- "isDirty": false,
- "version": 1687448761669,
- "lastModified": "2023-06-20T14:29:54.662Z",
- "publishDate": "2023-06-22T15:46:01.669Z",
- "account": "account-name"
}
Attaches a file to a course.
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
contentId required | string Specifies the content item. Found in the list all content response as the |
fileId required | string Specifies content file. Found in the list content files response as the |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location --request PUT 'https://api.us.lifeomic.com/v1/content/{projectId}/content/{contentId}/file-attachment/{fileId}' \ --header 'LifeOmic-Account: {account-id}' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {api-key}'
null
Lists the content files for your LifeOmic project.
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location 'https://api.us.lifeomic.com/v1/content/<projectId>/file' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>' \ --header 'Content-Type: application/json' \ --data '{"project":"<project-id>","name":"<filename>.<fileformat>"}'
{- "items": {
- "id": "e0b9e7f4-1474-42d6-b87a-a1e21e015c0c",
- "name": "<filename.fileformat>",
- "fileKey": "<fileKey>",
- "account": "<acccountName>",
- "project": "<projectId>",
- "size": 3146174,
- "contentType": "image/png",
- "lastModified": "2023-06-22T16:42:46.199Z",
- "type": "FILE",
- "meta": {
- "isDirectory": false,
- "private": false
}, - "lrn": "<lrnID>",
- "links": null,
- "self": "/v1/content/<projectId>/file"
}
}
Creates a new file placeholder in the content service. The POST call requires body data in the JSON format. This POST call is the first call in a two call operation for uploading content files. For more information, see Upload a File.
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
id | string The file id. If provided on POST, then the id must be a V4 UUID, otherwise the server will create a new UUID for the file. |
name | string The file name. |
datasetId | string The project the file belongs to. |
contentType | string The content type of the file. |
{- "id": "string",
- "name": "string",
- "datasetId": "string",
- "contentType": "string"
}
{- "id": "7c74a8e1-f118-4819-a2f7-04109a892c51,",
- "name": "test.json,",
- "datasetId": "ebe1618f-e474-4947-a6d2-18b19fac663a,",
- "contentType": "application/json,",
- "userId": "company:joe.smith.com,",
}
Deletes the content file specified with the file id.
fileId required | string The content file id |
projectId required | string Only return files in the specified dataset (projectId). See Find Your Project ID. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location --request DELETE 'https://api.us.lifeomic.com/v1/content/{projectId}/file/{fileId}' \ --header 'LifeOmic-Account: {account-id}' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {api-key}'
null
Creates an account, returning the account object.
id | string The account id. |
name | string The account name. |
owner | string <email> The account's owner. |
type | string Enum: "FREE" "PAID" "ENTERPRISE" The account type. |
{- "id": "string",
- "name": "string",
- "owner": "user@example.com",
- "type": "FREE"
}
{- "id": "string",
- "name": "string",
- "owner": "user@example.com",
- "type": "FREE"
}
Retrieves details about an account. Returns the account object.
id required | string The account id. |
include | string Value: "groups" Include additional information like the user's groups. |
{- "id": "string",
- "name": "string",
- "owner": "user@example.com",
- "type": "FREE"
}
Update an account by changing the name or clearing out a pending deletion date. Returns the account object.
id required | string The account id. |
name | string The account name. |
deletionDate | string The account's deletion date. Set to |
{- "name": "string",
- "deletionDate": "string"
}
{- "id": "string",
- "name": "string",
- "owner": "user@example.com",
- "type": "FREE"
}
Deletes an account. By default, the account will not be deleted for 14 days. During this time, the pending deletion can be cancelled by using the PATCH
method. After the 14 day grace period, the account and all of its data will be removed.
id required | string The account id. |
force | boolean If true, the 14 day grace period will be ignored and all of the account data will be removed immediately. |
Returns a list of clients belonging to an account.
id required | string The account id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "clients": [
- {
- "id": "string",
- "name": "string",
- "generateSecret": true,
- "callbackUrls": [
- "string"
], - "logoutUrls": [
- "string"
], - "identityProviders": [
- "GOOGLE"
], - "allowedOAuthFlows": [
- "code"
], - "customIdentityProvider": {
- "attributeMapping": [
- "string"
], - "metadataUrl": "string"
}
}
]
}
Create a new client for an account. Returns the client object.
id required | string The account id. |
LifeOmic-Account required | string The LifeOmic account to access. |
id | string The client id. |
name | string <= 64 characters The client name. |
generateSecret | boolean If true, a secret will be created for the client. |
callbackUrls | Array of strings [ 1 .. 100 ] items The list of callback URLs allowed for this client. |
logoutUrls | Array of strings [ 1 .. 100 ] items The list of logout allowed for this client. |
identityProviders | Array of strings non-empty Items Enum: "GOOGLE" "LIFEOMIC" "FACEBOOK" "CUSTOM" The list of identity providers allowed for this client. |
allowedOAuthFlows | Array of strings non-empty Items Enum: "code" "implicit" "client_credentials" The list of OAuth flows allowed for this client. |
object The custom identity provider to use for this client. |
{- "id": "string",
- "name": "string",
- "generateSecret": true,
- "callbackUrls": [
- "string"
], - "logoutUrls": [
- "string"
], - "identityProviders": [
- "GOOGLE"
], - "allowedOAuthFlows": [
- "code"
], - "customIdentityProvider": {
- "attributeMapping": [
- "string"
], - "metadataUrl": "string"
}
}
{- "id": "string",
- "name": "string",
- "generateSecret": true,
- "callbackUrls": [
- "string"
], - "logoutUrls": [
- "string"
], - "identityProviders": [
- "GOOGLE"
], - "allowedOAuthFlows": [
- "code"
], - "customIdentityProvider": {
- "attributeMapping": [
- "string"
], - "metadataUrl": "string"
}
}
Retrieves an account by clientId.
id required | string The account id. |
clientId required | string The client id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "string",
- "name": "string",
- "generateSecret": true,
- "callbackUrls": [
- "string"
], - "logoutUrls": [
- "string"
], - "identityProviders": [
- "GOOGLE"
], - "allowedOAuthFlows": [
- "code"
], - "customIdentityProvider": {
- "attributeMapping": [
- "string"
], - "metadataUrl": "string"
}
}
Updates a client for an account.
id required | string The account id. |
clientId required | string The client id. |
LifeOmic-Account required | string The LifeOmic account to access. |
id | string The client id. |
name | string <= 64 characters The client name. |
generateSecret | boolean If true, a secret will be created for the client. |
callbackUrls | Array of strings [ 1 .. 100 ] items The list of callback URLs allowed for this client. |
logoutUrls | Array of strings [ 1 .. 100 ] items The list of logout allowed for this client. |
identityProviders | Array of strings non-empty Items Enum: "GOOGLE" "LIFEOMIC" "FACEBOOK" "CUSTOM" The list of identity providers allowed for this client. |
allowedOAuthFlows | Array of strings non-empty Items Enum: "code" "implicit" "client_credentials" The list of OAuth flows allowed for this client. |
object The custom identity provider to use for this client. |
{- "id": "string",
- "name": "string",
- "generateSecret": true,
- "callbackUrls": [
- "string"
], - "logoutUrls": [
- "string"
], - "identityProviders": [
- "GOOGLE"
], - "allowedOAuthFlows": [
- "code"
], - "customIdentityProvider": {
- "attributeMapping": [
- "string"
], - "metadataUrl": "string"
}
}
{- "id": "string",
- "name": "string",
- "generateSecret": true,
- "callbackUrls": [
- "string"
], - "logoutUrls": [
- "string"
], - "identityProviders": [
- "GOOGLE"
], - "allowedOAuthFlows": [
- "code"
], - "customIdentityProvider": {
- "attributeMapping": [
- "string"
], - "metadataUrl": "string"
}
}
Supports operations for API keys
To learn about API key implementation on the LifeOmic Platform web app, see API Keys.
Returns a list of all API Keys for the logged in user.
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "name": "string",
- "id": "string",
- "key": "string",
- "dateCreated": "string",
- "dateExpires": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Create an API Key can that be used in API calls,
LifeOmic-Account required | string The LifeOmic account to access. |
name | string the API Key name |
expireInDays | number how long before the API key expires |
{- "name": "string",
- "expireInDays": 0
}
{- "name": "string",
- "id": "string",
- "key": "string",
- "dateCreated": "string",
- "dateExpires": "string"
}
Supports operations for storing and retrieving file data. For a guide to using the file service, see Getting Started with the File Service API.
Lists the files for your LifeOmic account. Refine your results to a specific project with the datasetId query parameter. For more information, see List Files.
name | string Filters the result set by performing a case-insensitive begins with filter on the file name. |
orderBy | string Enum: "name" "size" Allows one to order the results by file name or by size. Default is to sort by name in ascending order. To sort in descending order, add |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
datasetId | string Only return files in the specified dataset (project id). |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location 'https://api.us.lifeomic.com/v1/files?datasetId=<project-id>' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
{- "items": {
- "id": "bfdf7716-1088-4021-80b5-ab4badacd081,",
- "name": "initial_lab_report copy.pdf,",
- "datasetId": "ebe1618f-e474-4947-a6d2-18b19fac663a,",
- "size": "138829,",
- "contentType": "application/pdf,",
- "lastModified": "2020-11-17T14:35:14.823Z,",
- "userId": "lifeomic:lifeomic_joe.smith@company.com,",
- "lrn": "lrn:xyz:xyz:lifeomic:file:bfdf7716-1088-4021-80b5-ab4badacd081"
}, - "links": {
- "self": "/v1/files?datasetId=ebe1618f-e474-4947-a6d2-18b19fac663a,",
- "next": "/v1/files?nextPageToken=eyJpZCI6eyJTIjoibGlmZW9taWM6YmZkZjc3MTYtMTA4OC00MDIxLTgwYjUtYWI0YmFkYWNkMDgxIn0sImRhdGFzZXRJZCI6eyJTIjoibGlmZW9taWM6ZWJlMTYxOGYtZTQ3NC00OTQ3LWE2ZDItMThiMTlmYWM2NjNhIn0sInNvcnROYW1lIjp7IlMiOiJJTklUSUFMX0xBQl9SRVBPUlQgQ09QWS5QREYifX0=&datasetId=ebe1618f-e474-4947-a6d2-18b19fac663a"
}
}
Creates and uploads a file. Uploading files is a two call operation. The first call is a POST call for a response that contains the presigned URL. The POST call contains JSON data for the file in the body. The second call is a PUT call to upload the file to the presigned URL. For more information, see Upload Files.
LifeOmic-Account required | string The LifeOmic account to access. |
id | string The file id. If provided on POST, then the id must be a V4 UUID, otherwise the server will create a new UUID for the file. |
name | string The file name. |
datasetId | string The project the file belongs to. |
contentType | string The content type of the file. |
{- "id": "string",
- "name": "string",
- "datasetId": "string",
- "contentType": "string"
}
{- "id": "7c74a8e1-f118-4819-a2f7-04109a892c51,",
- "name": "test.json,",
- "datasetId": "ebe1618f-e474-4947-a6d2-18b19fac663a,",
- "contentType": "application/json,",
- "userId": "company:joe.smith.com,",
}
Downloads a file. Add the file id from the general GET files response and the include parameter with the downloadUrl value. The response contains the download url. For more information, see Download Files.
id required | string The file id. |
include | string Value: "downloadUrl" Specifying a value of |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location 'https://api.us.lifeomic.com/v1/files/<file-id>?include=downloadUrl' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
{- "id": "bfdf7716-1088-4021-80b5-ab4badacd081,",
- "name": "initial_lab_report copy.pdf,",
- "datasetId": "ebe1618f-e474-4947-a6d2-18b19fac663a,",
- "size": "138829,",
- "contentType": "application/pdf,",
- "lastModified": "2020-11-17T14:35:14.823Z,",
- "userId": "company:joe.smith@company.com,",
- "lrn": "lrn:xyz:xyz:company:file:bfdf7716-1088-4021-80b5-ab4badacd081,",
}
Deletes the file specified with the file id.
id required | string The file id. |
LifeOmic-Account required | string The LifeOmic account to access. |
curl --location --request DELETE 'https://api.us.lifeomic.com/v1/files/<file-id>' \ --header 'LifeOmic-Account: <account-id>' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <api-key>'
null
Supports operations with groups. To learn about the implementation of groups within the LifeOmic Platform web app, see Groups.
Returns the list of groups for an account.
name | string Search for groups whose name starts with the given string. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "account": "string",
- "description": "string",
- "id": "string",
- "type": "closed"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Returns the group with the given ID.
id required | string The group ID to lookup. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "account": "string",
- "description": "string",
- "id": "string",
- "type": "closed"
}
Updates the group identified by the given ID.
id required | string The group ID to modify. |
LifeOmic-Account required | string The LifeOmic account to access. |
The new information for the group.
account | string The account that owns the group. |
description | string A human readable description of the group. |
id | string The canonical identifier for the group. |
type | string Enum: "closed" "open" |
{- "account": "string",
- "description": "string",
- "id": "string",
- "type": "closed"
}
{- "account": "string",
- "description": "string",
- "id": "string",
- "type": "closed"
}
Returns the list of users belonging to the group.
id required | string The ID of the group |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "id": "string",
- "type": "string",
- "profile": {
- "email": "string",
- "familyName": "string",
- "givenName": "string",
- "name": "string",
- "picture": "string",
- "preferredUsername": "string"
}
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Removes the user from a group.
id required | string The ID of the group |
username required | string The user to add to the group |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Returns a list of invitations received or sent by the user, depending on parameters.
user | string The session user, whose received invitations should be fetched. |
account | string The account in which group invitations sent by the session user should be fetched. |
{- "items": [
- {
- "id": "string",
- "account": "string",
- "accountName": "string",
- "group": "string",
- "groupName": "string",
- "invitorUser": "string",
- "email": "string",
- "status": "AWAITING-USER-ACTION",
- "inviteTimestamp": "string",
- "expirationTimestamp": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Sends an email to a user, inviting them to join a group
group | string The group to which the user should be invited. |
string The invitee's email address. |
{- "group": "string",
- "email": "string"
}
{- "id": "string",
- "account": "string",
- "accountName": "string",
- "group": "string",
- "groupName": "string",
- "invitorUser": "string",
- "email": "string",
- "status": "AWAITING-USER-ACTION",
- "inviteTimestamp": "string",
- "expirationTimestamp": "string"
}
Performs an action on the invitation. If revoking an invitation, the accessAdmin Access Policy Privilege is required
id required | string The invitation ID to modify. |
status | string Enum: "ACCEPTED" "REJECTED" "REVOKED" The new status of the invitation. |
{- "status": "ACCEPTED"
}
null
Supports ABAC access control policy operations. For more information about the LifeOmic Platform Access Control, see the Access Control Overview.
Retrieves the ABAC policies of the user. See our open-sourced implementation of parsing ABAC policies at https://github.com/lifeomic/abac
{- "rules": {
- "apiKeyUser": true,
- "createData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "eed10b7f-8b8d-4182-a10b-7bf541ed4e36"
}
}
], - "readData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "eed10b7f-8b8d-4182-a10b-7bf541ed4e36"
}
}
], - "readMaskedData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "fc4c2a5e-6f24-4880-a5b7-c3ae51de1657"
}
}
]
}
}
Updates a policy for an account.
policyId required | string The policy id. |
LifeOmic-Account required | string The LifeOmic account. |
name | string Policy name |
object (Policy) An ABAC policy document. |
{- "name": "string",
- "policy": {
- "rules": {
- "apiKeyUser": true,
- "createData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "eed10b7f-8b8d-4182-a10b-7bf541ed4e36"
}
}
], - "readData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "eed10b7f-8b8d-4182-a10b-7bf541ed4e36"
}
}
], - "readMaskedData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "fc4c2a5e-6f24-4880-a5b7-c3ae51de1657"
}
}
]
}
}
}
{- "name": "string",
- "policy": {
- "rules": {
- "apiKeyUser": true,
- "createData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "eed10b7f-8b8d-4182-a10b-7bf541ed4e36"
}
}
], - "readData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "eed10b7f-8b8d-4182-a10b-7bf541ed4e36"
}
}
], - "readMaskedData": [
- {
- "resource.dataset": {
- "comparison": "equals",
- "value": "fc4c2a5e-6f24-4880-a5b7-c3ae51de1657"
}
}
]
}
}
}
Supports operations with the containers used to store datasets in a LifeOmic Platform account
Returns a list of all projects.
name | string Filters the result set by performing a case-insensitive begins with filter on the project name. |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "id": "string",
- "name": "string",
- "deletionDate": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates a project. Some resources refer to projects as datasets. The id of a project should be used whenever a datasetId
is needed.
LifeOmic-Account required | string The LifeOmic account to access. |
id | string The project id. Some resources use the term |
name | string The project name. |
deletionDate | string The project's deletion date. Set to |
{- "id": "string",
- "name": "string",
- "deletionDate": "string"
}
{- "id": "string",
- "name": "string",
- "deletionDate": "string"
}
Updates a project by changing the name or clearing out a pending deletion date.
id required | string The project id. |
id | string The project id. Some resources use the term |
name | string The project name. |
deletionDate | string The project's deletion date. Set to |
{- "id": "string",
- "name": "string",
- "deletionDate": "string"
}
{- "id": "string",
- "name": "string",
- "deletionDate": "string"
}
Deletes a project. By default, the project will not be deleted for 14 days. During this time, the pending deletion can be cancelled by using the PATCH
method. After the 14 day grace period, the project and all of its data will be removed.
id required | string The project id. |
force | boolean If true, the 14 day grace period will be ignored and all of the project data will be removed immediately. |
null
Returns the full profile for the currently authenticated user
{- "id": "string",
- "type": "string",
- "profile": {
- "email": "string",
- "familyName": "string",
- "givenName": "string",
- "name": "string",
- "picture": "string",
- "preferredUsername": "string"
}
}
Updates the authenticated user's profile
object |
{- "profile": {
- "email": "string",
- "familyName": "string",
- "givenName": "string",
- "name": "string",
- "picture": "string",
- "preferredUsername": "string"
}
}
{- "id": "string",
- "type": "string",
- "profile": {
- "email": "string",
- "familyName": "string",
- "givenName": "string",
- "name": "string",
- "picture": "string",
- "preferredUsername": "string"
}
}
Returns a users profile. When requesting one's own profile the full profile is returned. Otherwise a limited profile is returned.
username required | string The user to lookup |
{- "id": "string",
- "type": "string",
- "profile": {
- "email": "string",
- "familyName": "string",
- "givenName": "string",
- "name": "string",
- "picture": "string",
- "preferredUsername": "string"
}
}
Returns a list of groups that the user is a member of. This currently only succeeds if a user is asking for their own groups.
username required | string The user to list groups for |
{- "items": [
- {
- "account": "string",
- "description": "string",
- "id": "string",
- "type": "closed"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Update a user's profile picture. This only for the currently authorized user using a LifeOmic account.
username required | string The user to update the profile picture for |
Content-Type required | string The MIME type of the image being uploaded |
Content-Length required | number The size of the image payload in bytes |
The binary profile picture content
"string"
{- "downloadUrl": "string"
}
Supports operations with a domain specific language that query the analytics database. For more information, see the Insights API.
Returns the results a query that may span patients, genetic variants, and gene expression data.
dataset_id required | string |
cohort_id | string |
string_query | string |
required | object or object (AnalyticsDSL-Query) |
evaluate_contract | boolean |
{- "dataset_id": "string",
- "cohort_id": "string",
- "string_query": "string",
- "query": {
- "target": "patient",
- "domain": "procedure_overlap",
- "options": {
- "patients": [
- "string"
], - "codes": [
- "string"
], - "start": "string",
- "end": "string"
}
}, - "evaluate_contract": true
}
{- "data": { }
}
Supports operations, such as syncing and ingestion, with Electronic Health Records and the LifeOmic Platform
Returns a list of EHRs that the user has access to.
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "id": "string",
- "name": "string",
- "ehrType": "string",
- "creator": "string",
- "apiBaseUrl": "string",
- "apiAuthType": "string",
- "ingestionModel": "string",
- "delayBetweenRecords": 0
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Create an EHR configuration, which can then be connected to projects and used to sync data from your EHR to the LifeOmic Platform.
LifeOmic-Account required | string The LifeOmic account to access. |
id | string |
name required | string |
ehrType required | string Value: "cerbo" |
apiBaseUrl required | string <uri> ^https:\/\/[a-z]+\.md-hq\.com$ |
apiKey required | string |
apiSecret required | string |
apiAuthType required | string Value: "header" |
ingestionModel | string Enum: "ASYNCHRONOUS" "SYNCHRONOUS" |
delayBetweenRecords | number <= 3000 Number of milliseconds to pause in between each record during a SYNCHRONOUS ingestion. |
{- "id": "string",
- "name": "string",
- "ehrType": "cerbo",
- "apiKey": "string",
- "apiSecret": "string",
- "apiAuthType": "header",
- "ingestionModel": "ASYNCHRONOUS",
- "delayBetweenRecords": 3000
}
{- "id": "string",
- "name": "string",
- "ehrType": "cerbo",
- "apiKey": "string",
- "apiSecret": "string",
- "apiAuthType": "header",
- "ingestionModel": "ASYNCHRONOUS",
- "delayBetweenRecords": 3000
}
Returns an EHR.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "string",
- "name": "string",
- "ehrType": "cerbo",
- "apiKey": "string",
- "apiSecret": "string",
- "apiAuthType": "header",
- "ingestionModel": "ASYNCHRONOUS",
- "delayBetweenRecords": 3000
}
Updates an EHR.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "string",
- "name": "string",
- "ehrType": "cerbo",
- "apiKey": "string",
- "apiSecret": "string",
- "apiAuthType": "header",
- "ingestionModel": "ASYNCHRONOUS",
- "delayBetweenRecords": 3000
}
Returns a list of project connectors configured for this EHR.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates an EHR project connector, which represents the ability for this EHR to tie ingested records to the connected project.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
id required | string |
ehrId required | string |
project required | string |
{- "id": "string",
- "ehrId": "string",
- "project": "string"
}
{- "id": "string",
- "ehrId": "string",
- "project": "string"
}
Returns an EHR project connector.
ehrId required | string The EHR id. |
connectorId required | string The EHR connector id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "string",
- "ehrId": "string",
- "project": "string"
}
Deletes the EHR project connector.
ehrId required | string The EHR id. |
connectorId required | string The EHR connector id. |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Returns a list of EHR ingestions.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates an EHR ingestion, which represents a synchronization of EHR data to the LifeOmic Platform.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
Array of objects (EHRConnector) The subset of configured EHR project connectors that should be used for this ingestion. | |
Array of objects Individual records to be ingested. | |
consumePendingUpdates | boolean Whether or not this ingestion should add pending updates to its records array |
{- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}
{- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}
Returns a an EHR ingestions.
ehrId required | string The EHR id. |
ingestionId required | string The EHR ingestion id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Returns a list of scheduled EHR ingestions.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "ingestion": {
- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}, - "cronExpression": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates a recurring schedule on which an EHR ingestion should run.
ehrId required | string The EHR id. |
LifeOmic-Account required | string The LifeOmic account to access. |
object (EHRIngestion) | |
cronExpression | string |
{- "ingestion": {
- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}, - "cronExpression": "string"
}
{- "ingestion": {
- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}, - "cronExpression": "string"
}
Returns a scheduled EHR ingestion.
ehrId required | string The EHR id. |
scheduledIngestionId required | string The scheduled EHR ingestion id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "ingestion": {
- "connectors": [
- {
- "id": "string",
- "ehrId": "string",
- "project": "string"
}
], - "records": [
- {
- "type": "string",
- "id": "string"
}
], - "consumePendingUpdates": true
}, - "cronExpression": "string"
}
Deletes the scheduled EHR ingestion.
ehrId required | string The EHR id. |
scheduledIngestionId required | string The scheduled EHR ingestion id. |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Supports operations that provide an SQL interface to query FHIR resources on the LifeOmic Platform
project required | string The target project identifier |
scroll | string The _scroll_id from the previous request, which should be used to retrieve the next batch of results. |
LifeOmic-Account required | string Assigned LifeOmic account |
type required | string Value: "select" A DSL Statement Type |
required | string or (Array of FHIR-Column (object) or FHIR-Aggregation (object)) The Columns to Select |
required | Array of objects (FHIR-Table) The Table to Target |
FHIR-Where (object) | |
Array of objects or objects = 2 items The Offset and Limit |
{- "type": "select",
- "columns": "*",
- "from": [
- {
- "table": "string"
}
], - "where": {
- "type": "elasticsearch",
- "query": { },
- "highlight": { }
}, - "limit": [
- {
- "type": "number",
- "value": 0
}, - {
- "type": "number",
- "value": 0
}
]
}
{ }
project required | string The target project identifier |
patient required | string The target patient identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
type required | string Value: "select" A DSL Statement Type |
required | string or (Array of FHIR-Column (object) or FHIR-Aggregation (object)) The Columns to Select |
required | Array of objects (FHIR-Table) The Table to Target |
FHIR-Where (object) | |
Array of objects or objects = 2 items The Offset and Limit |
{- "type": "select",
- "columns": "*",
- "from": [
- {
- "table": "string"
}
], - "where": {
- "type": "elasticsearch",
- "query": { },
- "highlight": { }
}, - "limit": [
- {
- "type": "number",
- "value": 0
}, - {
- "type": "number",
- "value": 0
}
]
}
{ }
project required | string The target project identifier |
cohort required | string The target cohort identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
type required | string Value: "select" A DSL Statement Type |
required | string or (Array of FHIR-Column (object) or FHIR-Aggregation (object)) The Columns to Select |
required | Array of objects (FHIR-Table) The Table to Target |
FHIR-Where (object) | |
Array of objects or objects = 2 items The Offset and Limit |
{- "type": "select",
- "columns": "*",
- "from": [
- {
- "table": "string"
}
], - "where": {
- "type": "elasticsearch",
- "query": { },
- "highlight": { }
}, - "limit": [
- {
- "type": "number",
- "value": 0
}, - {
- "type": "number",
- "value": 0
}
]
}
{ }
Endpoint will programmatically optimize the search query
project required | string The target project identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
field required | string The field to select |
resource required | string The resource type to query |
FHIR-Where (object) | |
size | number Maximum list size to be returned |
FHIR-SearchAfter (object) |
{- "field": "string",
- "resource": "string",
- "where": {
- "type": "elasticsearch",
- "query": { },
- "highlight": { }
}, - "size": 0,
- "after": {
- "type": "elasticsearch",
- "search_after": [ ]
}
}
{ }
pageSize | string |
nextPageToken | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "size": 0,
- "checksum": "string",
- "createdAt": "2019-08-24T14:15:22Z"
}
], - "links": {
- "self": "string",
- "next": { }
}
}
LifeOmic-Account required | string Assigned LifeOmic account |
name required | string A user friendly name for the firmware file |
{- "name": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
}
id required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "size": 0,
- "checksum": "string",
- "createdAt": "2019-08-24T14:15:22Z"
}
firmwareId required | string |
pageSize | string |
nextPageToken | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "firmwareId": "44bbc267-0d43-4d6e-8f0e-67a633a4574d",
- "startedAt": "2019-08-24T14:15:22Z",
- "target": {
- "type": "group",
- "group": "string"
}, - "status": "active",
- "progress": {
- "total": 0,
- "completed": 0,
- "inProgress": 0,
- "queued": 0,
- "failed": 0
}
}
], - "links": {
- "self": "string",
- "next": { }
}
}
firmwareId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
required | object The target configuration for this deployment. |
{- "target": {
- "type": "group",
- "group": "string"
}
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "firmwareId": "44bbc267-0d43-4d6e-8f0e-67a633a4574d",
- "startedAt": "2019-08-24T14:15:22Z",
- "target": {
- "type": "group",
- "group": "string"
}, - "status": "active",
- "progress": {
- "total": 0,
- "completed": 0,
- "inProgress": 0,
- "queued": 0,
- "failed": 0
}
}
firmwareId required | string |
deploymentId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
status required | string Value: "cancelled" |
{- "status": "cancelled"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "firmwareId": "44bbc267-0d43-4d6e-8f0e-67a633a4574d",
- "startedAt": "2019-08-24T14:15:22Z",
- "target": {
- "type": "group",
- "group": "string"
}, - "status": "active",
- "progress": {
- "total": 0,
- "completed": 0,
- "inProgress": 0,
- "queued": 0,
- "failed": 0
}
}
id required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
name required | string The name of the group. |
project required | string The unique identifier of the project the group belongs to. |
filter required | string The filter that describes the group. Device filters must be a valid STU3 FHIR Device query string. |
{- "name": "string",
- "project": "string",
- "filter": "string"
}
{- "id": "string",
- "name": "string",
- "project": "string",
- "filter": "string",
- "createdAt": "2019-08-24T14:15:22Z"
}
id required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "id": "string",
- "name": "string",
- "project": "string",
- "filter": "string",
- "createdAt": "2019-08-24T14:15:22Z"
}
project required | string The unique identifier of the project the group belongs to. |
pageSize | string |
nextPageToken | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string",
- "name": "string",
- "project": "string",
- "filter": "string",
- "createdAt": "2019-08-24T14:15:22Z"
}
], - "links": {
- "self": "string",
- "next": { }
}
}
id required | string |
pageSize | string |
nextPageToken | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string"
}
], - "links": {
- "self": "string",
- "next": { }
}
}
pageSize | string |
nextPageToken | string |
filter required | string The filter that describes the group. Device filters must be a valid STU3 FHIR Device query string. |
project required | string The unique identifier of the project the group belongs to. |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string"
}
], - "links": {
- "self": "string",
- "next": { }
}
}
projectId | string |
pageSize | string |
nextPageToken | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "certificateId": "string",
- "name": "string",
- "projectId": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
LifeOmic-Account required | string Assigned LifeOmic account |
name required | string |
projectId required | string |
{- "name": "string",
- "projectId": "string"
}
{- "certificateId": "string",
- "name": "string",
- "certificatePem": "string",
- "privateKey": "string",
- "publicKey": "string"
}
Supports operations with NPPES database medical services and/or custom services
Returns a list of NPPES database medical services and/or custom services.
projectId required | string The ID of the project to search within. |
LifeOmic-Account required | string The LifeOmic account to access. |
zipCode required | number (Zip Code) [ 10001 .. 99999 ] |
searchRadius | number (Search Radius) [ 0 .. 300 ] |
omitNPIRecords | boolean (Omit NPI Records) Omit NPPES NPI records from the search set and only search custom services |
omitCustomServices | boolean (Omit Custom Services) Omit custom services from the search set and only search NPPES NPI records |
pageSize | number (Page Size) [ 1 .. 100 ] |
nextPageToken | string (Next Page Token) |
taxonomy required | string (Taxonomy) |
{- "zipCode": 10001,
- "searchRadius": 300,
- "omitNPIRecords": true,
- "omitCustomServices": true,
- "pageSize": 1,
- "nextPageToken": "string",
- "taxonomy": "string"
}
{- "results": [
- {
- "source": "custom-service",
- "service": {
- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
}
]
}
Returns a single NPI record or custom service.
projectId required | string The ID of the project to search within. |
serviceId required | string The ID of the NPI record or custom service |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "result": {
- "source": "custom-service",
- "service": {
- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
}
}
projectId required | string The ID of the project that owns the custom service. |
serviceId required | string The ID of the custom service |
LifeOmic-Account required | string The LifeOmic account to access. |
serviceId | string (Service ID) The ID of the custom service or NPI record. If augmenting an NPI record, this service ID should match the NPI number |
taxonomy required | string (Taxonomy) Either a standard NPPES taxonomy or any custom taxonomy |
zipCode required | number (Zip Code) [ 10001 .. 99999 ] |
rank required | number (Rank) Rank determines how results are sorted. The higher the rank, the lower index it will be returned in the response list. Ranks of custom services >= 0 are returned before NPPES NPI records. Ranks < 0 are returned after NPPES NPI records. |
isNPIRecord required | boolean (Is NPI Record) Flag indicating if this service is supposed to augment an NPI record or be a separate custom service. |
object (PartialNPIRecord) | |
additionalProperties | object (Additional Properties) Any additional properties to associate with an NPI record or custom service |
{- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
{- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
projectId required | string The ID of the project that owns the custom service. |
serviceId required | string The ID of the custom service |
LifeOmic-Account required | string The LifeOmic account to access. |
null
projectId required | string The ID of the project that owns the custom service. |
LifeOmic-Account required | string The LifeOmic account to access. |
serviceId | string (Service ID) The ID of the custom service or NPI record. If augmenting an NPI record, this service ID should match the NPI number |
taxonomy required | string (Taxonomy) Either a standard NPPES taxonomy or any custom taxonomy |
zipCode required | number (Zip Code) [ 10001 .. 99999 ] |
rank required | number (Rank) Rank determines how results are sorted. The higher the rank, the lower index it will be returned in the response list. Ranks of custom services >= 0 are returned before NPPES NPI records. Ranks < 0 are returned after NPPES NPI records. |
isNPIRecord required | boolean (Is NPI Record) Flag indicating if this service is supposed to augment an NPI record or be a separate custom service. |
object (PartialNPIRecord) | |
additionalProperties | object (Additional Properties) Any additional properties to associate with an NPI record or custom service |
{- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
{- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
projectId required | string The ID of the project that owns the custom service. |
LifeOmic-Account required | string The LifeOmic account to access. |
pageSize | number (Page Size) [ 1 .. 100 ] |
nextPageToken | string (Next Page Token) |
{- "pageSize": 1,
- "nextPageToken": "string"
}
{- "results": [
- {
- "serviceId": "string",
- "taxonomy": "string",
- "zipCode": 10001,
- "rank": 0,
- "isNPIRecord": true,
- "npiRecordOverride": {
- "addresses": [
- {
- "address_1": "string",
- "address_2": "string",
- "address_purpose": "string",
- "address_type": "string",
- "city": "string",
- "country_code": "string",
- "country_name": "string",
- "postal_code": "string",
- "state": "string",
- "telephone_number": "string"
}
], - "basic": {
- "certification_date": "string",
- "credential": "string",
- "enumeration_date": "string",
- "first_name": "string",
- "gender": "F",
- "last_name": "string",
- "last_updated": "string",
- "name": "string",
- "sole_proprietor": "NO"
}, - "created_epoch": 0,
- "enumeration_type": "NPI-1",
- "identifiers": [
- {
- "code": "string",
- "desc": "string",
- "identifier": "string",
- "issuer": "string",
- "status": "string"
}
]
}, - "additionalProperties": { }
}
], - "nextPageToken": "string"
}
Supports operations for OCR
To learn about the service as implemented in the LifeOmic Platform web app, see OCR Overview.
Create OCR configuration for a project in the LifeOmic Platform
LifeOmic-Account required | string The LifeOmic Platform account to access. |
project required | string <uuid> LifeOmic project ID |
required | object (OcrConfig) |
{- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "config": {
- "pathPrefix": "ocr",
- "denoiserSwitch": "ON",
- "classifierSwitch": "OFF",
- "analyzeSwitch": "OFF",
- "analyzeConfidence": "HIGH",
- "spellCheckerSwitch": "OFF",
- "reportExtractionSwitch": "OFF",
- "reviewStages": [
- "string"
], - "searchLists": {
- "lists": [
- {
- "title": "string",
- "searchTerms": [
- {
- "term": "string",
- "coding": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "resourceTypes": [
- "MedicationAdministration"
]
}
]
}
]
}
}
}
{- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "config": {
- "pathPrefix": "ocr",
- "denoiserSwitch": "ON",
- "classifierSwitch": "OFF",
- "analyzeSwitch": "OFF",
- "analyzeConfidence": "HIGH",
- "spellCheckerSwitch": "OFF",
- "reportExtractionSwitch": "OFF",
- "reviewStages": [
- "string"
], - "searchLists": {
- "lists": [
- {
- "title": "string",
- "searchTerms": [
- {
- "term": "string",
- "coding": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "resourceTypes": [
- "MedicationAdministration"
]
}
]
}
]
}
}
}
Retrieve the OCR configuration for a project in the LifeOmic Platform
projectId required | string LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "config": {
- "pathPrefix": "ocr",
- "denoiserSwitch": "ON",
- "classifierSwitch": "OFF",
- "analyzeSwitch": "OFF",
- "analyzeConfidence": "HIGH",
- "spellCheckerSwitch": "OFF",
- "reportExtractionSwitch": "OFF",
- "reviewStages": [
- "string"
], - "searchLists": {
- "lists": [
- {
- "title": "string",
- "searchTerms": [
- {
- "term": "string",
- "coding": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "resourceTypes": [
- "MedicationAdministration"
]
}
]
}
]
}
}
}
Update OCR configuration for a project in LifeOmic
projectId required | string LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
project required | string <uuid> LifeOmic project ID |
required | object (OcrConfig) |
{- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "config": {
- "pathPrefix": "ocr",
- "denoiserSwitch": "ON",
- "classifierSwitch": "OFF",
- "analyzeSwitch": "OFF",
- "analyzeConfidence": "HIGH",
- "spellCheckerSwitch": "OFF",
- "reportExtractionSwitch": "OFF",
- "reviewStages": [
- "string"
], - "searchLists": {
- "lists": [
- {
- "title": "string",
- "searchTerms": [
- {
- "term": "string",
- "coding": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "resourceTypes": [
- "MedicationAdministration"
]
}
]
}
]
}
}
}
{- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "config": {
- "pathPrefix": "ocr",
- "denoiserSwitch": "ON",
- "classifierSwitch": "OFF",
- "analyzeSwitch": "OFF",
- "analyzeConfidence": "HIGH",
- "spellCheckerSwitch": "OFF",
- "reportExtractionSwitch": "OFF",
- "reviewStages": [
- "string"
], - "searchLists": {
- "lists": [
- {
- "title": "string",
- "searchTerms": [
- {
- "term": "string",
- "coding": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "resourceTypes": [
- "MedicationAdministration"
]
}
]
}
]
}
}
}
Delete OCR configuration for a project in LifeOmic
projectId required | string LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Create a DocumentReference, representing a PDF file and its OCR pipeline
analyzeTypes | string Type of analysis to perform, comma separated string of values 'TABLES', 'FORMS' |
LifeOmic-Account required | string The LifeOmic account to access. |
project required | string <uuid> LifeOmic Project identifier |
subject | string Subject identifier of the subject the file should be associated with |
fileId required | string Identifier of the original file in file-service |
externalId | string External identifier for associating with an external system |
Array of objects Array of FHIR extensions to be attached to the DocumentReference | |
object or string Type/Class of document. This value will be applied to all pages. | |
customPageDate | string Date of document. This value will be applied to all pages. |
{- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "subject": "string",
- "fileId": "string",
- "externalId": "string",
- "extensions": [
- {
- "url": "string",
- "value[x]": "string"
}
], - "customPageClassification": {
- "code": "string",
- "system": "string",
- "display": "string"
}, - "customPageDate": "string"
}
{- "documentReferenceId": "string"
}
Re process a document, creates a new DocumentReference ID
projectId required | string <uuid> LifeOmic Project Id |
documentReferenceId required | string <uuid> DocumentReference identfier |
cohort | string <uuid> Cohort Identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "documentReferenceId": "string"
}
Retrieve a document page as an image
projectId required | string <uuid> LifeOmic Project Id |
documentReferenceId required | string <uuid> DocumentReference identfier |
page required | integer Page number |
Width | number Width of cropped image |
Height | number Height of cropped image |
Top | number Top coordinate for crop |
Left | number Left coordinate for crop |
Rotate | number Rotation angle |
Quality | number Expected image quality |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Create a list of concepts from user defined ontology file
projectId required | string <uuid> LifeOmic Project Id |
fileId required | string <uuid> File-service identifier of file to be processed |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "documentReferenceId": "string"
}
Retrieve a list of user defined ontology concepts
projectId required | string <uuid> LifeOmic Project Id |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "project": "string",
- "account": "string",
- "fileId": "string",
- "user": "string",
- "systems": [
- "string"
], - "ontologyIds": [
- "string"
], - "created": "string",
- "fileName": "string",
- "version": "string"
}
Retrieve a list of dates suggested from a pool of source compositions
projectId required | string <uuid> LifeOmic Project Id |
LifeOmic-Account | string The LifeOmic account to access. |
object (CodeableConcept) | |
sourceDocumentReference | string <uuid> If supplied, dates are only suggested from sources within the specified document reference |
omitSourceCompositions | Array of strings The IDs of compositions that should not be included in the source data for suggestions |
object or object |
{- "sourceClassification": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "sourceDocumentReference": "758c1cdc-7a99-4847-9aa3-63408e963028",
- "omitSourceCompositions": [
- "string"
], - "dateSuggestionInput": {
- "type": "text",
- "text": "string"
}
}
[- {
- "score": 0,
- "date": "string",
- "dateWordIds": [
- "string"
], - "dateText": "string",
- "sourceDateText": "string",
- "sourceDocumentReference": "string",
- "sourcePageIndex": "string",
- "sourceSnippet": "string"
}
]
Retrieve metadata with url and bounding box information of the snippet
projectId required | string <uuid> LifeOmic Project Id |
documentReferenceId required | string <uuid> DocumentReference identifier |
page required | number Page number |
lineIndices | string Array of line indices for which snippets are needed |
wordIndex | string Identifier of word for which snippet is needed |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "boundingBox": { },
- "pdfPageS3Url": "string",
- "aspectRatio": {
- "width": 0,
- "height": 0
}, - "rotation": 0
}
Update a DocumentReference
projectId required | string <uuid> LifeOmic project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
cohort | string <uuid> Cohort identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
{ }
Retrieve a DocumentReference
projectId required | string <uuid> LifeOmic Project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
{ }
Deletes a DocumentReference and attached artifacts
projectId required | string <uuid> LifeOmic Project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
retainFiles | boolean |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Analyze an OCR document
projectId required | string <uuid> LifeOmic Project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Create a redacted PDF
projectId required | string <uuid> LifeOmic Project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "redactedFileId": "11fb4854-0d7a-44cb-a08a-a7236f8b00f8",
- "redactedFileName": "string"
}
Retrieve FHIR Suggestions
projectId required | string <uuid> LifeOmic Project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
pageSize | number Number of elements per call |
nextPageToken | string Token to retrive the next page |
excludeFields | string Fields to exclude in response (reduces payload size) |
codingLimit | string Limit the number of codings in response (reduces payload size) |
confidenceLimit | string Enum: "HIGH" "STRONG" "MODERATE" "LOW" "OFF" Confidence limit for analysis |
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "account": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "documentReference": "34eb98f6-99b5-46b4-9cd0-0b7f3289cc59",
- "suggestionId": "34122dbe-9acf-41b0-b725-60a09cf38f81",
- "pageSectionSuggestions": "string",
- "wordIds": [
- "string"
], - "originalText": "string",
- "suggestions": { },
- "comprehendResults": { },
- "documentPage": "string",
- "primaryConfidence": 0,
- "anchorDate": "2019-08-24T14:15:22Z"
}
]
Retrieve FHIR suggestions for a page
projectId required | string <uuid> LifeOmic Project identifier |
documentReferenceId required | string <uuid> DocumentReference identifier |
pages required | string Page indicies (comma separated string) |
excludeFields | string Fields to exclude in response (reduces payload size) |
codingLimit | string Limit the number of codings in response (reduces payload size) |
confidenceLimit | string Enum: "HIGH" "STRONG" "MODERATE" "LOW" "OFF" Confidence limit for analysis |
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "account": "string",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "documentReference": "34eb98f6-99b5-46b4-9cd0-0b7f3289cc59",
- "suggestionId": "34122dbe-9acf-41b0-b725-60a09cf38f81",
- "pageSectionSuggestions": "string",
- "wordIds": [
- "string"
], - "originalText": "string",
- "suggestions": { },
- "comprehendResults": { },
- "documentPage": "string",
- "primaryConfidence": 0,
- "anchorDate": "2019-08-24T14:15:22Z"
}
]
Updates codings in relevant FHIR resources
projectId required | string <uuid> LifeOmic Project identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
required | object (CodeableConcept) |
required | object (CodeableConcept) |
{- "searchTerm": {
- "system": "string",
- "code": "string",
- "display": "string"
}, - "replaceTerm": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
null
Create an OCR report extractor
projectId required | string <uuid> LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
id required | string <uuid> Report extractor identifier |
project required | string <uuid> LifeOmic project identifier |
required | ReportExtractor (object) or ReportExtractorMeta (object) |
account required | string LifeOmic account name |
creatorUser required | string User who created the extractor |
lastUpdated required | string <date-time> Timestamp of last update |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "reportExtractor": {
- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}, - "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z"
}
{- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}
List OCR report extractors
projectId required | string <uuid> LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "reportExtractor": {
- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}, - "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z"
}
]
List OCR report extractors for account
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "reportExtractor": {
- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}, - "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z"
}
]
Retrieve OCR report extractor
projectId required | string <uuid> LifeOmic project ID |
reportExtractorId required | string <uuid> LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "reportExtractor": {
- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}, - "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z"
}
Update an OCR report extractor
projectId required | string <uuid> LifeOmic project ID |
reportExtractorId required | string <uuid> LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
id required | string <uuid> Report extractor identifier |
project required | string <uuid> LifeOmic project identifier |
required | ReportExtractor (object) or ReportExtractorMeta (object) |
account required | string LifeOmic account name |
creatorUser required | string User who created the extractor |
lastUpdated required | string <date-time> Timestamp of last update |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
- "reportExtractor": {
- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}, - "account": "string",
- "creatorUser": "string",
- "lastUpdated": "2019-08-24T14:15:22Z"
}
{- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}
Delete an OCR report extractor
projectId required | string <uuid> LifeOmic project ID |
reportExtractorId required | string <uuid> LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Extract report for a document reference, with given report extractor
projectId required | string <uuid> LifeOmic project ID |
documentReferenceId required | string <uuid> DocumentReference identifier |
reportExtractorId required | string <uuid> ReportExtractor identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Extract report for a document reference and report extractor
projectId required | string <uuid> LifeOmic project ID |
documentReferenceId required | string <uuid> DocumentReference identifier |
reportExtractorId required | string <uuid> ReportExtractor identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Bulk extract report for a document reference, with all available report extractors
projectId required | string <uuid> LifeOmic project ID |
documentReferenceId required | string <uuid> DocumentReference identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Delete report for a document reference
projectId required | string <uuid> LifeOmic project ID |
documentReferenceId required | string <uuid> DocumentReference identifier |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Bulk extract report for a document reference, with all available report extractors
projectId required | string <uuid> LifeOmic project ID |
LifeOmic-Account required | string The LifeOmic account to access. |
documentReferenceId required | string <uuid> |
required | object (ReportExtractor) The reportExtractor property is unnecessary and can be removed when it is no longer sent to the API |
{- "documentReferenceId": "34e0e764-a84b-4ab5-81c2-32cd312ddb0d",
- "reportExtractor": {
- "name": "string",
- "description": "string",
- "extractor": [
- {
- "category": "projection",
- "type": "branch",
- "branchPipelines": [
- [ ]
], - "description": "string",
- "filters": [
- {
- "type": "regex",
- "scope": "page",
- "regex": "string"
}
], - "condition": {
- "conditions": [
- null
], - "type": "and"
}, - "debug": true
}
], - "codes": [
- {
- "code": {
- "system": "string",
- "code": "string",
- "display": "string"
}
}
], - "reportExtractor": null
}
}
{- "results": "error",
- "result": {
- "resource": { },
- "wordIds": [
- "string"
]
}
}
Supports operations for ontologies on the LifeOmic Platform
To learn about the service as implemented in the LifeOmic Platform web app, see the Ontologies Overview.
Creates a relationship.
project required | string Target project identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
The relationship to create
equivalence | string Enum: "relatedto" "equivalent" "equal" "wider" "subsumes" "narrower" "specializes" "inexact" "unmatched" "disjoint" The degree of equivalence between concepts. |
object or string | |
object or string |
{- "equivalence": "relatedto",
- "source": {
- "type": "coding",
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}, - "target": {
- "type": "coding",
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
}
null
Creates many relationships.
project required | string Target project identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
The relationships to create
equivalence | string Enum: "relatedto" "equivalent" "equal" "wider" "subsumes" "narrower" "specializes" "inexact" "unmatched" "disjoint" The degree of equivalence between concepts. |
object or string | |
object or string |
[- {
- "equivalence": "relatedto",
- "source": {
- "type": "coding",
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}, - "target": {
- "type": "coding",
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
}
]
[- {
- "href": "string",
- "status": "string",
- "message": "string"
}
]
Get a relationship.
project required | string Target project identifier |
relationship required | string Relationship identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
[- {
- "equivalence": "relatedto",
- "source": {
- "type": "coding",
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}, - "target": {
- "type": "coding",
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
}
]
Delete a relationship.
project required | string Target project identifier |
relationship required | string Relationship identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
null
Creates a coding.
project required | string Target project identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
The coding to create
system | string or null The identification of the code system that defines the meaning of the symbol in the code. |
version | string or null The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured. and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged. |
code | string or null[^\s]+([\s]?[^\s]+)* A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
display | string or null A representation of the meaning of the code in the system, following the rules of the system. |
{- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
null
Gets a collection of codings.
project required | string Target project identifier |
system required | string The identification of the code system that defines the meaning of the symbol in the code. |
version | string The version of the code system which was used when choosing this code. |
code | string A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
display | string A representation of the meaning of the code in the system, following the rules of the system. |
LifeOmic-Account required | string Assigned LifeOmic account |
[- {
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
]
Deletes all matching codings. This operation cannot be undone.
project required | string Target project identifier |
system required | string The identification of the code system that defines the meaning of the symbol in the code. |
version | string The version of the code system which was used when choosing this code. |
code | string A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
display | string A representation of the meaning of the code in the system, following the rules of the system. |
LifeOmic-Account required | string Assigned LifeOmic account |
null
Gets a coding.
project required | string Target project identifier |
coding required | string Coding identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
Delete a coding.
project required | string Target project identifier |
coding required | string Coding identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
null
Lists available code systems from a Marketplace context.
project required | string Target project identifier |
availability | any Enum: "project" "account" The availability(ies) to include, default is both project and account. Example |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "contact": { }
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates a code system that is owned and maintained by the specified project.
project required | string Target project identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
title | string non-empty |
description | string non-empty |
publisher | string non-empty |
copyright | string non-empty |
url required | string non-empty |
version | string non-empty |
null or Array of objects |
{- "title": "string",
- "description": "string",
- "publisher": "string",
- "copyright": "string",
- "url": "string",
- "version": "string",
- "contact": { }
}
{- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "contact": { }
}
Lists code systems that are owned and maintained by the specified project.
project required | string Target project identifier |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "contact": { }
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Fetches a single code system with the provided id.
project required | string Target project identifier |
code-system required | string Desired code system's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "contact": { }
}
Updates a code system with the given ID
project required | string Target project identifier |
code-system required | string Desired code system's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
The updated code system
null or string | |
null or string | |
null or string | |
null or string | |
null or any | |
null or Array of objects |
{- "title": { },
- "description": { },
- "publisher": { },
- "copyright": { },
- "availability": { },
- "contact": { }
}
{- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "contact": { }
}
Deletes a code system with the given ID
project required | string Target project identifier |
code-system required | string Desired code system's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
null
Gets a collection of codings from the specified code system.
project required | string Target project identifier |
code-system required | string Desired code system's ID |
code | string A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
display | string A representation of the meaning of the code in the system, following the rules of the system. |
LifeOmic-Account required | string Assigned LifeOmic account |
[- {
- "items": [
- {
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
]
Gets a coding from the specified code system
project required | string Target project identifier |
code-system required | string Desired code system's ID |
coding required | string Coding identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
Gets associated code systems for the current project
project required | string Target project identifier |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string Assigned LifeOmic account |
Creates an association between the specified project and the specified code system
project required | string Target project identifier |
code-system required | string Desired code system's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
Removes an association between the specified project and the specified code system
project required | string Target project identifier |
code-system required | string Desired code system's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
Lists available value sets from a Marketplace context.
project required | string Target project identifier |
availability | any Enum: "project" "account" The availability(ies) to include, default is both project and account. Example '?availability=account&availability=project' |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "immutable": true,
- "contact": [
- {
- "name": "string",
- "telecom": [
- {
- "system": "phone",
- "value": "string",
- "use": "home",
- "rank": 1,
- "period": {
- "start": 1,
- "end": 1
}
}
]
}
]
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Lists value sets that are owned and maintained by the specified project.
project required | string Target project identifier |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "items": [
- {
- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "immutable": true,
- "contact": [
- {
- "name": "string",
- "telecom": [
- {
- "system": "phone",
- "value": "string",
- "use": "home",
- "rank": 1,
- "period": {
- "start": 1,
- "end": 1
}
}
]
}
]
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Creates a value set that is owned and maintained by the specified project.
project required | string Target project identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
title | string non-empty |
description | string non-empty |
publisher | string non-empty |
copyright | string non-empty |
url required | string non-empty |
version | string non-empty |
null or Array of objects |
{- "title": "string",
- "description": "string",
- "publisher": "string",
- "copyright": "string",
- "url": "string",
- "version": "string",
- "contact": { }
}
{- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "immutable": true,
- "contact": [
- {
- "name": "string",
- "telecom": [
- {
- "system": "phone",
- "value": "string",
- "use": "home",
- "rank": 1,
- "period": {
- "start": 1,
- "end": 1
}
}
]
}
]
}
Fetches a single value set with the provided id.
project required | string Target project identifier |
value-set required | string Desired value set's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "immutable": true,
- "contact": [
- {
- "name": "string",
- "telecom": [
- {
- "system": "phone",
- "value": "string",
- "use": "home",
- "rank": 1,
- "period": {
- "start": 1,
- "end": 1
}
}
]
}
]
}
Updates a value set with the given ID
project required | string Target project identifier |
value-set required | string Desired value set's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
null or string | |
null or string | |
null or string | |
null or string | |
null or any | |
null or Array of objects |
{- "title": { },
- "description": { },
- "publisher": { },
- "copyright": { },
- "availability": { },
- "contact": { }
}
{- "id": "string",
- "availability": "PROJECT",
- "title": "string",
- "description": "string",
- "url": "string",
- "version": "string",
- "publisher": "string",
- "copyright": "string",
- "immutable": true,
- "contact": [
- {
- "name": "string",
- "telecom": [
- {
- "system": "phone",
- "value": "string",
- "use": "home",
- "rank": 1,
- "period": {
- "start": 1,
- "end": 1
}
}
]
}
]
}
Deletes a value set with the given ID
project required | string Target project identifier |
value-set required | string Desired value set's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
null
Gets a collection of codings from the specified value set.
project required | string Target project identifier |
value-set required | string Desired value set's ID |
code | string A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
display | string A representation of the meaning of the code in the system, following the rules of the system. |
LifeOmic-Account required | string Assigned LifeOmic account |
[- {
- "items": [
- {
- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
]
Adds codings to the specified value set, pulling from the specified code system by id.
project required | string Target project identifier |
value-set required | string Desired value set's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
codeSystemId | string The code system origin of the codings |
codingIds | Array of strings [ 1 .. 1000 ] items |
{- "codeSystemId": "string",
- "codingIds": [
- "string"
]
}
{- "results": [
- {
- "status": 0,
- "codingId": "string",
- "message": "string"
}
]
}
Removes codings from the specified value set by id.
project required | string Target project identifier |
value-set required | string Desired value set's ID |
id required | string Coding id to remove from the value set, can be multiple. E.G. ?id={string}&id={string} |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "results": [
- {
- "status": 0,
- "codingId": "string",
- "message": "string"
}
]
}
Gets a coding from the specified value set
project required | string Target project identifier |
value-set required | string Desired value set's ID |
coding required | string Coding identifier |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "system": "string",
- "version": "string",
- "code": "string",
- "display": "string"
}
Gets associated value set for the current project
project required | string Target project identifier |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string Assigned LifeOmic account |
Creates an association between the specified project and the specified value set
project required | string Target project identifier |
value-set required | string Desired value set's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
Removes an association between the specified project and the specified value set
project required | string Target project identifier |
value-set required | string Desired value set's ID |
LifeOmic-Account required | string Assigned LifeOmic account |
Creates a new model via a model config object.
LifeOmic-Account required | string Assigned LifeOmic account |
name required | string |
description required | string |
required | TuningJobTrainingApproach (object) (TrainingApproach) |
required | EdgeDeployApproach (object) or CloudDeployApproach (object) (DeployApproach) |
object (EvaluationApproach) | |
required | ClassificationProblemInput (object) or ClassificationProblemInput (object) (MlProblemDefinitionInput) |
property name* additional property | any |
{- "name": "string",
- "description": "string",
- "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}, - "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string"
}
]
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}
}
{- "model": {
- "name": "string",
- "description": "string",
- "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}, - "id": "string",
- "accountId": "string",
- "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "index": 255
}
], - "maxLabelIndex": -1
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}, - "deployedId": "string",
- "championId": "string"
}
}
Gets all model configs for an account.
LifeOmic-Account required | string Assigned LifeOmic account |
{- "models": [
- {
- "name": "string",
- "description": "string",
- "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}, - "id": "string",
- "accountId": "string",
- "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "index": 255
}
], - "maxLabelIndex": -1
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}, - "deployedId": "string",
- "championId": "string"
}
]
}
Updates a model config.
id required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
name required | string |
description required | string |
required | TuningJobTrainingApproach (object) (TrainingApproach) |
required | EdgeDeployApproach (object) or CloudDeployApproach (object) (DeployApproach) |
object (EvaluationApproach) | |
required | ClassificationProblemInput (object) or ClassificationProblemInput (object) (MlProblemDefinitionInput) |
property name* additional property | any |
{- "name": "string",
- "description": "string",
- "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}, - "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string"
}
]
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}
}
{- "model": {
- "name": "string",
- "description": "string",
- "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}, - "id": "string",
- "accountId": "string",
- "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "index": 255
}
], - "maxLabelIndex": -1
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}, - "deployedId": "string",
- "championId": "string"
}
}
Gets a model config.
id required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "model": {
- "name": "string",
- "description": "string",
- "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}, - "id": "string",
- "accountId": "string",
- "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "index": 255
}
], - "maxLabelIndex": -1
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}, - "deployedId": "string",
- "championId": "string"
}
}
Begins a new ML run for a given model.
modelId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
null
{- "runId": "string"
}
Gets data for all ML runs for a model.
modelId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "runs": [
- {
- "id": "string",
- "slug": "string",
- "modelId": "string",
- "accountId": "string",
- "modelArtifactUri": "string",
- "status": "running",
- "error": "string",
- "deployStatus": "deploying",
- "deployError": "string",
- "start": 0,
- "end": 0,
- "isArchived": true,
- "splits": {
- "train": {
- "n": 0,
- "start": 0,
- "end": 0,
- "uri": "string"
}, - "val": {
- "n": 0,
- "start": 0,
- "end": 0,
- "uri": "string"
}, - "test": {
- "n": 0,
- "start": 0,
- "end": 0,
- "uri": "string"
}
}, - "hyperparameters": [
- {
- "name": "string",
- "value": "string"
}
], - "championId": "string",
- "metrics": {
- "challenger": [
- {
- "name": "string",
- "value": 0,
- "stage": "training"
}
], - "champion": [
- {
- "name": "string",
- "value": 0,
- "stage": "training"
}
]
}, - "approvals": [
- {
- "timestamp": 0,
- "decision": "approved",
- "actor": "system"
}
], - "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "index": 255
}
], - "maxLabelIndex": -1
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}, - "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}
}
]
}
Gets data for a particular run.
modelId required | string |
runId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "run": {
- "id": "string",
- "slug": "string",
- "modelId": "string",
- "accountId": "string",
- "modelArtifactUri": "string",
- "status": "running",
- "error": "string",
- "deployStatus": "deploying",
- "deployError": "string",
- "start": 0,
- "end": 0,
- "isArchived": true,
- "splits": {
- "train": {
- "n": 0,
- "start": 0,
- "end": 0,
- "uri": "string"
}, - "val": {
- "n": 0,
- "start": 0,
- "end": 0,
- "uri": "string"
}, - "test": {
- "n": 0,
- "start": 0,
- "end": 0,
- "uri": "string"
}
}, - "hyperparameters": [
- {
- "name": "string",
- "value": "string"
}
], - "championId": "string",
- "metrics": {
- "challenger": [
- {
- "name": "string",
- "value": 0,
- "stage": "training"
}
], - "champion": [
- {
- "name": "string",
- "value": 0,
- "stage": "training"
}
]
}, - "approvals": [
- {
- "timestamp": 0,
- "decision": "approved",
- "actor": "system"
}
], - "problemDefinition": {
- "retrainEvery": 0,
- "labelDefinition": {
- "labels": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "index": 255
}
], - "maxLabelIndex": -1
}, - "problemType": "imgSeg",
- "trainingDataFilter": {
- "filterType": "FhirCodesFilter",
- "codes": [
- "string"
]
}
}, - "trainingApproach": {
- "type": "tuningJob",
- "trainingImage": "string",
- "metricDefinitions": [
- {
- "name": "string",
- "regex": "string"
}
], - "objective": {
- "direction": "minimize",
- "metric": "string"
}, - "searchSpace": [
- {
- "type": "categorical",
- "name": "string",
- "values": [
- "string"
]
}
], - "maxTrials": 1
}, - "deployApproach": {
- "inferenceImage": "string",
- "type": "edge"
}, - "evaluationApproach": {
- "type": "customImage",
- "imageUri": "string"
}
}
}
Gets a url that can be used to download the model artifact for a particular run.
modelId required | string |
runId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "url": "string"
}
Gets the log events for a particular run.
modelId required | string |
runId required | string |
filter | string An optional field used to filter the log events. This parameter supports AWS CloudWatch Logs' filter and pattern syntax. See https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html for instructions on how to write filters. |
marker | string Passed in to control which page of results is retrieved. |
limit | string The maximum number of events to return. The default is to return 10,000 -- the largest allowed. |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "events": [
- {
- "type": "logEntry",
- "timestamp": 0,
- "payload": "string",
- "stage": "string"
}
], - "marker": "string"
}
Adds a new approval decision to a model run.
modelId required | string |
runId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
choice required | string (ApprovalChoice) Enum: "approved" "rejected" |
{- "choice": "approved"
}
{- "approvalDecision": {
- "timestamp": 0,
- "decision": "approved",
- "actor": "user",
- "user": "string"
}
}
Fetches a page of training data examples for data labeling.
modelId required | string |
projectId required | string |
hasLabel | string |
hasUnconfirmedLabel | string Allows for fetching examples that have unconfirmed labels. |
marker | string |
patientId | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "examples": [
- {
- "id": "string",
- "updatedAt": 0,
- "exampleType": "imgSeg",
- "image": {
- "fileId": "string"
}, - "label": {
- "isConfirmed": true,
- "lastConfirmedBy": "string",
- "updatedAt": 0,
- "tags": [
- {
- "name": "string",
- "value": "string"
}
], - "labelType": "imgSeg",
- "mask": {
- "fileId": "string"
}
}
}
], - "marker": "string"
}
Fetches a single training data example for data labeling.
modelId required | string |
exampleId required | string |
projectId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "example": {
- "id": "string",
- "updatedAt": 0,
- "exampleType": "imgSeg",
- "image": {
- "fileId": "string"
}, - "label": {
- "isConfirmed": true,
- "lastConfirmedBy": "string",
- "updatedAt": 0,
- "tags": [
- {
- "name": "string",
- "value": "string"
}
], - "labelType": "imgSeg",
- "mask": {
- "fileId": "string"
}
}
}
}
Updates the label for a training data example
modelId required | string |
exampleId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
isConfirmed | boolean A confirmed label is believed to be correct and may be used during training and evaluation. |
lastConfirmedBy | string The email address or other identifier of the user who last confirmed this label. |
updatedAt | number Timestamp for when the label was last updated or created expressed as milliseconds since the UTC epoch. |
Array of objects (Tags) | |
labelType required | string Value: "imgSeg" |
required | object The fileId of an image containing per-pixel labels |
property name* additional property | any |
{- "isConfirmed": true,
- "lastConfirmedBy": "string",
- "updatedAt": 0,
- "tags": [
- {
- "name": "string",
- "value": "string"
}
], - "labelType": "imgSeg",
- "mask": {
- "fileId": "string"
}
}
{- "id": "string",
- "updatedAt": 0,
- "exampleType": "imgSeg",
- "image": {
- "fileId": "string"
}, - "label": {
- "isConfirmed": true,
- "lastConfirmedBy": "string",
- "updatedAt": 0,
- "tags": [
- {
- "name": "string",
- "value": "string"
}
], - "labelType": "imgSeg",
- "mask": {
- "fileId": "string"
}
}
}
Retrieves the label file for the given example, if it exists, and converts it to the format LabelStudio expects.
modelId required | string |
exampleId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
{- "labelData": {
- "labelType": "imgSeg",
- "projectId": "string",
- "height": 0,
- "width": 0,
- "areas": [
- {
- "id": "string",
- "rle": [
- 0
]
}
]
}
}
Preprocesses the label data and updates the label file for a training data example. This is done for ML problem types that store their labels as independent files, such as image segmentation. For those problem types, The label data is not stored on a label FHIR record, but in a separate file-service file, and pointed to by a label FHIR record.
modelId required | string |
exampleId required | string |
LifeOmic-Account required | string Assigned LifeOmic account |
labelType required | string Value: "imgSeg" |
projectId required | string The ID of the LifeOmic project the label file is saved under. |
height required | integer The height of the segmentation mask in pixels. |
width required | integer The width of the segmentation mask in pixels. |
required | Array of objects (ImageSegmentationArea) |
{- "labelType": "imgSeg",
- "projectId": "string",
- "height": 0,
- "width": 0,
- "areas": [
- {
- "id": "string",
- "rle": [
- 0
]
}
]
}
{- "fileId": "string"
}
Supports FHIR resource operations on the LifeOmic Platform
FHIR operations take place on https://fhir.us.lifeomic.com.
Returns a searchset of a resource type that includes the unique identifiers for the individual resource. FHIR offers sophisticated parameters for search operations, see FHIR Search.
LifeOmic also offers a FHIR Search service that utilizes Elasticsearch and searches on any field, see the FHIR Search tab.
account required | string Assigned name to the customer's account, usually a short form of the company name |
dstu3 required | string Signifies the LifeOmic supported FHIR version STU3 |
resourceType required | string A value set defined by the FHIR project. Commonly used examples are observation and patient |
curl --location --request GET\ --url 'https://fhir.lifeomic.com/{account}/dstu3/{resourceType}/' \ --header 'Authorization=Bearer <api-key>' \
{- "resourceType": "Bundle",
- "link": [
- {
- "relation": "self",
- "url": "/lifeomic/dstu3/patient/"
}, - {
- "relation": "next",
- "url": "/lifeomic/dstu3/patient/?next=10"
}
], - "type": "searchset",
- "entry": [
- {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Schmeler",
- "given": [
- "Nola"
]
}
], - "gender": "female",
- "birthDate": "1954-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-10-25T21:29:15.417Z"
}, - "id": "00000623-04ad-4d69-991f-6388f4bff4a9"
}, - "fullUrl": "/lifeomic/dstu3/Patient/00000623-04ad-4d69-991f-6388f4bff4a9"
}
]
}
Creates a new specific instance of a resource type with the unique id assigned by the system. Any supplied id is ignored. The 201 response body contains the assigned id. To assign an id to a resource, see PUT Update a FHIR resource.
account required | string Assigned name to the customer's account, usually a short form of the company name |
dstu3 required | string Signifies the LifeOmic supported FHIR version STU3 |
resourceType required | string A value set defined by the FHIR project. Commonly used examples are observation and patient |
{- "resourceType": "Patient",
- "name": [
- {
- "family": "Smith",
- "given": [
- "John"
]
}
], - "gender": "male",
- "birthDate": "1984-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-11-25T21:29:15.417Z"
}
}
{- "resourceType": "Patient",
- "name": [
- {
- "family": "Smith",
- "given": [
- "John"
]
}
], - "gender": "male",
- "birthDate": "1984-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2023-03-08T19:04:46.018Z"
}, - "extension": [
], - "id": "8f194dc0-ef5e-4702-b729-d978529adf07"
}
Shows the data for the specific instance of a resource type and its current state specified by id.
account required | string Assigned name to the customer's account, usually a short form of the company name |
dstu3 required | string Signifies the LifeOmic supported FHIR version STU3 |
resourceType required | string A value set defined by the FHIR project. Commonly used examples are observation and patient |
id required | number A unique identifier for that specific resource |
curl --location --request GET\ --url 'https://fhir.lifeomic.com/{account}/dstu3/{resourceType}/{id}' \ --header 'Authorization=Bearer <api-key>' \
{- "resourceType": "Patient",
- "name": [
- {
- "family": "Smith",
- "given": [
- "Julia"
]
}
], - "gender": "female",
- "birthDate": "1964-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-10-25T21:29:15.417Z"
}, - "id": "00000623-04ad-4d69-991f-6388f4bff4a9"
}
Removes a specific resource from the database
account required | string Assigned name to the customer's account, usually a short form of the company name |
dstu3 required | string Signifies the LifeOmic supported FHIR version STU3 |
resourceType required | string A value set defined by the FHIR project. Commonly used examples are observation and patient |
id required | number A unique identifier for that specific resource |
curl --location --request DELETE\ --url 'https://fhir.lifeomic.com/{account}/dstu3/{resourceType}/{id}' \ --header 'Authorization=Bearer <api-key>' \
null
Creates a new current version for an existing resource or creates an initial version if no resource already exists for the given id.
account required | string Assigned name to the customer's account, usually a short form of the company name |
dstu3 required | string Signifies the LifeOmic supported FHIR version STU3 |
resourceType required | string A value set defined by the FHIR project. Commonly used examples are observation and patient |
id required | number A unique identifier for that specific resource |
{- "resourceType": "Patient",
- "name": [
- {
- "family": "Smith",
- "given": [
- "Jim"
]
}
], - "gender": "male",
- "birthDate": "1984-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-11-25T21:29:15.417Z"
}, - "id": "8f194dc0-ef5e-4702-b729-d978529adf07"
}
{- "resourceType": "Patient",
- "name": [
- {
- "family": "Smith",
- "given": [
- "Bob"
]
}
], - "gender": "male",
- "birthDate": "1984-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2023-03-09T15:02:04.163Z"
}, - "id": "8f194dc0-ef5e-4702-b729-d978529adf07"
}
You can can use a POST request with the _search parameter to search FHIR in addition to the GET request search. The POST request includes the query parameters in the body of the request. Insert the query parameters in the body of the request in the URL-encoded format. In Postman, this is the x-www-form-urlencoded option under the body tab.
LifeOmic also offers a FHIR Search service that utilizes Elasticsearch and searches on any field, see the FHIR Search tab.
account required | string Assigned name to the customer's account, usually a short form of the company name |
dstu3 required | string Signifies the LifeOmic supported FHIR version STU3 |
resourceType required | string A value set defined by the FHIR project. Commonly used examples are observation and patient |
_search? required | string Specifies the search interaction |
code | string An industry standard code value, such as a LOINC, SNOMED, or RxNorm code, or a LifeOmic custom code. For example |
date | string Specifies the date, for example |
patient | string Specifies the patient id, for example |
_tag | string Specifies the dataset/project. You must encode the url in the format: |
orderBy | string Specify sort order with one of the fields you are searching on. Example: |
pageSize | number The number of results to return in the request. |
{- "resourceType": "Bundle",
- "link": [
- {
- "relation": "self",
- "url": "/lifeomic/dstu3/Patient/_search"
}, - {
- "relation": "next",
- "url": "/lifeomic/dstu3/Patient/_search?next=10"
}
], - "type": "searchset",
- "entry": [
- {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Schmeler",
- "given": [
- "Nola"
]
}
], - "gender": "female",
- "birthDate": "1954-02-01",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-10-25T21:29:15.417Z"
}, - "id": "00000623-04ad-4d69-991f-6388f4bff4a9"
}, - "fullUrl": "/lifeomic/dstu3/Patient/00000623-04ad-4d69-991f-6388f4bff4a9"
}, - {
- "resource": {
- "resourceType": "Patient",
- "identifier": [
- {
- "value": "27372"
}
], - "extension": [
- {
- "valueCodeableConcept": {
}
}
], - "gender": "female",
- "birthDate": "2025-07-21",
- "maritalStatus": {
}, - "meta": {
- "tag": [
]
}, - "id": "00001b90-fce2-4d8c-977e-9fcdc016e1d5"
}, - "fullUrl": "/lifeomic/dstu3/Patient/00001b90-fce2-4d8c-977e-9fcdc016e1d5"
}, - {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Rau",
- "given": [
- "Warren"
]
}
], - "gender": "male",
- "birthDate": "1938-09-23",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-10-25T21:29:34.430Z"
}, - "id": "00005375-9c78-49d6-81af-358be75e2bff"
}, - "fullUrl": "/lifeomic/dstu3/Patient/00005375-9c78-49d6-81af-358be75e2bff"
}, - {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Hammes",
- "given": [
- "Malika"
]
}
], - "gender": "male",
- "birthDate": "1922-11-24",
- "meta": {
- "tag": [
]
}, - "id": "0000ac51-7e9a-4948-b7ab-405ad5b06ee5"
}, - "fullUrl": "/lifeomic/dstu3/Patient/0000ac51-7e9a-4948-b7ab-405ad5b06ee5"
}, - {
- "resource": {
- "resourceType": "Patient",
- "meta": {
- "tag": [
]
}, - "name": [
- {
- "text": "Test Person",
- "use": "official",
- "family": "Person",
- "given": [
- "Test"
]
}
], - "telecom": [
- {
- "system": "email",
- "value": "test@example.com",
- "use": "home"
}, - {
- "system": "phone",
- "value": "317-555-5555",
- "use": "home"
}
], - "gender": "unknown",
- "address": [
- {
- "line": [
- "123 Sesame St"
], - "city": "Indy",
- "state": "IN",
- "postalCode": "46126"
}
], - "birthDate": "1960-11-11",
- "id": "0000ce48-c53d-4ffb-8a44-f86f28fbef01"
}, - "fullUrl": "/lifeomic/dstu3/Patient/0000ce48-c53d-4ffb-8a44-f86f28fbef01"
}, - {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Shields",
- "given": [
- "Kelley"
]
}
], - "gender": "female",
- "birthDate": "1992-01-18",
- "identifier": [
], - "meta": {
- "tag": [
], - "lastUpdated": "2021-09-02T17:21:38.884Z"
}, - "id": "0000d827-6bbf-4899-8927-1ca2d00d1be8"
}, - "fullUrl": "/lifeomic/dstu3/Patient/0000d827-6bbf-4899-8927-1ca2d00d1be8"
}, - {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Yost",
- "given": [
- "Brandyn"
]
}
], - "gender": "female",
- "birthDate": "1974-12-27",
- "meta": {
- "tag": [
]
}, - "id": "00011efa-b948-4086-a8fc-52c2e991bc91"
}, - "fullUrl": "/lifeomic/dstu3/Patient/00011efa-b948-4086-a8fc-52c2e991bc91"
}, - {
- "resource": {
- "resourceType": "Patient",
- "identifier": [
- {
}
], - "name": [
- {
- "use": "official",
- "given": [
- "Katee"
], - "family": "Bethany"
}
], - "address": [
- {
- "use": "home"
}
], - "telecom": [
- {
- "system": "email",
- "value": "katee.bethany@gmail.com"
}, - {
- "system": "phone"
}
], - "meta": {
- "tag": [
], - "lastUpdated": "2022-07-15T09:43:38.264Z",
- "versionId": "1657878218"
}, - "id": "000120aa-e161-4785-bb76-aa72b973dce3"
}, - "fullUrl": "/lifeomic/dstu3/Patient/000120aa-e161-4785-bb76-aa72b973dce3"
}, - {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Kunze",
- "given": [
- "Arvel"
]
}
], - "gender": "male",
- "birthDate": "1925-09-02",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-09-12T17:36:35.326Z"
}, - "id": "0001325f-ff54-41d7-b22c-ecc17047c98c"
}, - "fullUrl": "/lifeomic/dstu3/Patient/0001325f-ff54-41d7-b22c-ecc17047c98c"
}, - {
- "resource": {
- "resourceType": "Patient",
- "name": [
- {
- "family": "Stehr",
- "given": [
- "Anya"
]
}
], - "gender": "female",
- "birthDate": "1925-01-13",
- "meta": {
- "tag": [
], - "lastUpdated": "2019-10-22T19:12:11.292Z"
}, - "id": "00017dfe-dbc0-477b-b3e1-b51a9115b190"
}, - "fullUrl": "/lifeomic/dstu3/Patient/00017dfe-dbc0-477b-b3e1-b51a9115b190"
}
]
}
Supports updating the ABAC policy for a user.
For more information about the LifeOmic Platform Access Control, see the Access Control Overview.
Updates the policy attributes for the specified user, returning the updated attributes.
Using this API requires access to the accessAdmin
operation.
username required | string |
LifeOmic-Account required | string The LifeOmic account to access. |
required | object |
{- "attributes": { }
}
{- "attributes": { }
}
Fetches the policy attributes for the specified user.
Using this API requires access to the accessAdmin
operation.
username required | string |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "attributes": { }
}
Returns a list of rules that the user has access to.
datasetId required | string The ID of the project to search within for rules. |
inputType | string Enum: "event" "questionnaireResponse" Only return rules that have the given input type. If this is specified, then you can supply other input properties for the given |
eventType | string Enum: "PatientWriteEvent" "FileChangeEvent" Only valid when |
resourceType | string Only valid when |
id | string <uuid> Only valid when |
status | string Only valid when |
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "account": "myComp",
- "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "userId": "myUser",
- "name": "Example Rule",
- "description": "This is just an example rule",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "updatedTime": "2020-01-01T00:00:00.000Z",
- "input": {
- "type": "event",
- "attributes": {
- "eventType": "PatientWriteEvent",
- "resourceType": "Observation",
- "actions": [
- "create",
- "update"
]
}
}, - "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
]
}
]
Create a rule that will execute based on the given input, running each step in sequence until a step returns false, or all steps have completed. The input defines what causes the rule to fire.
LifeOmic-Account required | string The LifeOmic account to access. |
id | string <uuid> Unique ID for this rule. |
account required | string The account the rule belongs to. |
datasetId required | string The ID of the dataset this rule belongs to. |
userId | string The ID of the user that created this rule. |
name required | string <= 256 characters The name given to the rule. |
description | string <= 1024 characters A more detailed description of the rule, so users can get more information about its purpose. |
creationTime | string <date-time> An ISO formatted timestamp of when the Rule was created. |
updatedTime | string <date-time> An ISO formatted timestamp of when the Rule was last updated. |
required | object or object (Rules-Input) Base input schema. The type of input used is dependent on the |
required | Array of objects or objects or objects (Rules-Step) The steps that should be executed when this rule is triggered. These steps will be executed in order, until one of them returns false or fails. |
{- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "account": "myComp",
- "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "userId": "myUser",
- "name": "Example Rule",
- "description": "This is just an example rule",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "updatedTime": "2020-01-01T00:00:00.000Z",
- "input": {
- "type": "event",
- "attributes": {
- "eventType": "PatientWriteEvent",
- "resourceType": "Observation",
- "actions": [
- "create",
- "update"
]
}
}, - "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
]
}
{- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "account": "myComp",
- "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "userId": "myUser",
- "name": "Example Rule",
- "description": "This is just an example rule",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "updatedTime": "2020-01-01T00:00:00.000Z",
- "input": {
- "type": "event",
- "attributes": {
- "eventType": "PatientWriteEvent",
- "resourceType": "Observation",
- "actions": [
- "create",
- "update"
]
}
}, - "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
]
}
Returns a rule.
ruleId required | string <uuid> The rule id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "account": "myComp",
- "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "userId": "myUser",
- "name": "Example Rule",
- "description": "This is just an example rule",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "updatedTime": "2020-01-01T00:00:00.000Z",
- "input": {
- "type": "event",
- "attributes": {
- "eventType": "PatientWriteEvent",
- "resourceType": "Observation",
- "actions": [
- "create",
- "update"
]
}
}, - "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
]
}
Returns a list of rule jobs that the user has access to.
datasetId required | string The ID of the project to search within for rule jobs. |
state required | string Enum: "RUNNING" "COMPLETE" "CANCELED" Only return rule jobs that have the given state. |
pageSize | number Default: 10 The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "userId": "myUser",
- "account": "myComp",
- "policy": {
- "rules": {
- "readData": true
}
}, - "accountGroups": [
- "users-group",
- "admin-group"
], - "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "state": "RUNNING",
- "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
], - "resourceType": "Patient",
- "execution": "arn:execution",
- "successes": 12,
- "failures": 3,
- "total": 20
}
]
Create a rule job that will execute the given steps for each of the given resource IDs. Rule jobs only support patient resources for now. The job will asynchronously execute the steps for each resource in batches, allowing it to handle large numbers of resources.
LifeOmic-Account required | string The LifeOmic account to access. |
datasetId | string The ID of the dataset this rule job belongs to. |
required | Array of objects or objects or objects (Rules-Step) The steps that should be executed when this rule job is triggered. These steps will be executed in order, until one of them returns false or fails. |
resourceType required | string Value: "Patient" The type of resource that are batched up and have the steps executed against. |
resourceIds required | Array of strings The list of resource IDs that you want to execute the steps against, in batches. |
{- "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
], - "resourceType": "Patient",
- "resourceIds": [
- "b61c4273-b59d-4a3b-8efe-02304c8850af",
- "8173433d-b995-4389-aa5d-27d8a56c5687"
]
}
{- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "userId": "myUser",
- "account": "myComp",
- "policy": {
- "rules": {
- "readData": true
}
}, - "accountGroups": [
- "users-group",
- "admin-group"
], - "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "state": "RUNNING",
- "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
], - "resourceType": "Patient",
- "execution": "arn:execution",
- "successes": 12,
- "failures": 3,
- "total": 20
}
Returns a rule job.
jobId required | string <uuid> The rule job id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "creationTime": "2020-01-01T00:00:00.000Z",
- "userId": "myUser",
- "account": "myComp",
- "policy": {
- "rules": {
- "readData": true
}
}, - "accountGroups": [
- "users-group",
- "admin-group"
], - "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "state": "RUNNING",
- "steps": [
- {
- "type": "transform",
- "attributes": {
- "property": "person.fullName",
- "value": "{{person.firstName}} {{person.lastName}}"
}
}
], - "resourceType": "Patient",
- "execution": "arn:execution",
- "successes": 12,
- "failures": 3,
- "total": 20
}
Returns a a list of items for a rule job.
jobId required | string <uuid> The rule job id. |
state | string Enum: "PENDING" "RUNNING" "SUCCESS" "FAILURE" Only return rule job items that have the given state. |
pageSize | number Default: 10 The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
[- {
- "sequence": 6,
- "account": "myComp",
- "datasetId": "edf88862-cb60-4f12-be89-a50e09dc8ae7",
- "jobId": "785ec0fa-77a4-49ab-b9ac-a5462d365ae8",
- "state": "RUNNING",
- "resourceId": "b61c4273-b59d-4a3b-8efe-02304c8850af"
}
]
Manages an SFTP user to access standard SFTP methods and tools for files in the LifeOmic Platform
To learn about the service as implemented by the LifeOmic Platform web app, see SFTP Data Transfer.
Get events for a SFTP user
projectId required | string The project id. |
username required | string The username |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "dateTime": "string",
- "level": "string",
- "message": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Delete a SFTP user for a given project.
projectId required | string The project id. |
username required | string The username |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Get a SFTP user for a given project.
projectId required | string The project id. |
username required | string The username |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "username": "string",
- "description": "string",
- "sshKeys": [
- "string"
], - "homeDirectory": "string",
- "createdBy": "string",
- "dateCreated": "2019-08-24T14:15:22Z",
- "dateUpdated": "2019-08-24T14:15:22Z"
}
Update a SFTP user for a given project.
projectId required | string The project id. |
username required | string The username |
LifeOmic-Account required | string The LifeOmic account to access. |
sshKeys | Array of strings List of publich SSH keys for the user. |
description | string A user description |
homeDirectory | string The location within the LifeOmic Project where the user can write files |
{- "sshKeys": [
- "string"
], - "description": "string",
- "homeDirectory": "string"
}
{- "username": "string",
- "description": "string",
- "sshKeys": [
- "string"
], - "homeDirectory": "string",
- "createdBy": "string",
- "dateCreated": "2019-08-24T14:15:22Z",
- "dateUpdated": "2019-08-24T14:15:22Z"
}
Create a SFTP users for a given project.
projectId required | string The project id. |
LifeOmic-Account required | string The LifeOmic account to access. |
username | string The SFTP username |
description | string A user description |
sshKeys | Array of strings List of publich SSH keys for the user. |
homeDirectory | string The location within the LifeOmic project where the user can write files |
createdBy | string The LifeOmic Platform username that created the SFTP user |
dateCreated | string <date-time> The date when the user was created |
dateUpdated | string <date-time> The date when the user was last updated |
{- "username": "string",
- "description": "string",
- "sshKeys": [
- "string"
], - "homeDirectory": "string",
- "createdBy": "string",
- "dateCreated": "2019-08-24T14:15:22Z",
- "dateUpdated": "2019-08-24T14:15:22Z"
}
{- "username": "string",
- "description": "string",
- "sshKeys": [
- "string"
], - "homeDirectory": "string",
- "createdBy": "string",
- "dateCreated": "2019-08-24T14:15:22Z",
- "dateUpdated": "2019-08-24T14:15:22Z"
}
Lists all of the SFTP users for a given project.
projectId required | string The project id. |
username | string Filter results by SFTP username. |
pageSize | string The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "username": "string",
- "description": "string",
- "sshKeys": [
- "string"
], - "homeDirectory": "string",
- "createdBy": "string",
- "dateCreated": "2019-08-24T14:15:22Z",
- "dateUpdated": "2019-08-24T14:15:22Z"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Supports operations for sending surveys with the LifeOmic Platform
For more information about surveys as implemented on the LifeOmic Platform web app, see the Surveys Overview.
projectId required | string |
object | |
survey required | string non-empty The id of the survey associated with the response |
current | boolean non-empty Set to true to assign the most recent published version of the survey. |
notificationType | string Enum: "EMAIL" "PUSH" |
object or object |
{- "invite": {
- "group": "string"
}, - "survey": "string",
- "current": true,
- "notificationType": "EMAIL",
- "subject": {
- "id": "string",
- "email": "string"
}
}
projectId required | string |
responseId required | string |
required | object |
required | object |
resourceType required | string Value: "QuestionnaireResponse" |
authored | string Date the response was submitted. Formatted YYYY-MM-DDTHH:mm:ss.sssZ |
object | |
status | string Enum: "in-progress" "completed" |
item | Array of arrays array of survey questions |
{- "subject": {
- "reference": "string",
- "display": "string"
}, - "questionnaire": {
- "reference": "string",
- "display": "string"
}, - "resourceType": "QuestionnaireResponse",
- "authored": "string",
- "author": {
- "reference": "string"
}, - "status": "in-progress",
- "item": [ ]
}
projectId required | string |
responseId required | string |
linkId required | string |
fileName required | string |
contentType | string |
{- "fileName": "string",
- "contentType": "string"
}
projectId required | string |
resourceType required | string Value: "Questionnaire" |
title required | string^[^<>&/`@]+$ Name of the survey |
status required | string Enum: "draft" "active" "retried" Use draft for a new survey, active for an existing survey that is to be publicly available, and retired for archived surveys that should no longer be used. |
item required | Array of arrays non-empty List of survey questions |
{- "resourceType": "Questionnaire",
- "title": "string",
- "status": "draft",
- "item": [ ]
}
projectId required | string |
surveyId required | string |
resourceType required | string Value: "Questionnaire" |
title required | string^[^<>&/`@]+$ Name of the survey |
status required | string Enum: "draft" "active" "retried" Use draft for a new survey, active for an existing survey that is to be publicly available, and retired for archived surveys that should no longer be used. |
item required | Array of arrays non-empty List of survey questions |
{- "resourceType": "Questionnaire",
- "title": "string",
- "status": "draft",
- "item": [ ]
}
projectId required | string |
surveyId required | string |
recurrence required | string Enum: "continuously" "daily" "weekly" "monthly" "yearly" |
stopAfter | number |
remind | boolean |
expire | boolean |
{- "recurrence": "continuously",
- "stopAfter": 0,
- "remind": true,
- "expire": true
}
projectId required | string |
surveyId required | string |
resourceType required | string Value: "Questionnaire" |
title required | string^[^<>&/`@]+$ Name of the survey |
status required | string Enum: "draft" "active" "retried" Use draft for a new survey, active for an existing survey that is to be publicly available, and retired for archived surveys that should no longer be used. |
item required | Array of arrays non-empty List of survey questions |
{- "resourceType": "Questionnaire",
- "title": "string",
- "status": "draft",
- "item": [ ]
}
Supports direct access to cloud data in a secure compute environment with your own code inside Docker containers
Returns a list of tasks that the user has access to.
datasetId required | string The ID of the project to search within for tasks. |
state | string Only return tasks in the given state. |
name | string Only return tasks that have a name that starts with the given value. |
orderBy | string Specify sort order. Example: |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Create a task that will run Docker images against data in the LifeOmic Platform. The Docker images can be accessed from DockerHub. To use a private image, run docker save
to save the image to a TAR file. You can then upload the TAR file to the LifeOmic Platform and provide it as an input to the Task using the DOCKER_IMAGE
input type. The image will be loaded from the TAR file during task execution making the image available to any executors
defined in the task.
LifeOmic-Account required | string The LifeOmic account to access. |
name | string <= 256 characters |
datasetId required | string |
description | string <= 1024 characters |
scheduleExpression | string A CRON expression for a recurring task |
scheduleDate | string <date-time> A date-time string for when the task should be scheduled to run |
maxDurationSeconds | number [ 60 .. 864000 ] |
object A key-value map of arbitrary tags. | |
object | |
required | Array of objects <= 20 items A list of executors to be run, sequentially. Execution stops on the first error. |
required | object or object Request that the task be run with these resources. |
required | Array of objects or objects or objects or objects or objects <= 25 items Input files. Inputs will be downloaded and mounted into the executor container. |
required | Array of objects or objects or objects or (object or objects) or (object or objects) or objects or objects or objects or objects <= 25 items Output files. Outputs will be uploaded from the executor container to long-term storage. |
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
Returns a task.
taskId required | string The task id. |
view | string Default: "FULL" Enum: "FULL" "MINIMAL" Affects the fields included in the returned Task. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
Cancels a task.
taskId required | string The task id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
Create a Foundation Medicine import task.
LifeOmic-Account required | string The LifeOmic account to access. |
xmlFileId required | string |
datasetId required | string |
reportFileId | string |
subjectId required | string |
sequenceName | string |
performerId | string |
testType | string |
indexedDate | string |
indexType | string |
useExistingSequence | boolean |
sequenceId | string |
reIngestFile | boolean |
bodySite | string |
bodySiteSystem | string |
bodySiteDisplay | string |
sendFailedTo | string <email> If present, send emails for failed tasks to this email address. |
{- "xmlFileId": "string",
- "datasetId": "string",
- "reportFileId": "string",
- "subjectId": "string",
- "sequenceName": "string",
- "performerId": "string",
- "testType": "string",
- "indexedDate": "string",
- "indexType": "string",
- "useExistingSequence": true,
- "sequenceId": "string",
- "reIngestFile": true,
- "bodySite": "string",
- "bodySiteSystem": "string",
- "bodySiteDisplay": "string",
- "sendFailedTo": "user@example.com"
}
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
Create a Nantomics import task.
LifeOmic-Account required | string The LifeOmic account to access. |
nantomicsVcfFileId required | string |
datasetId required | string |
outputFilePrefix required | string |
subjectId required | string |
sequenceName | string |
sequenceType required | string Enum: "somatic" "germline" |
performerId | string |
testType | string |
indexedDate | string |
uploadType | string |
useExistingSequence | boolean |
reIngestFile | boolean |
bodySite | string |
bodySiteSystem | string |
bodySiteDisplay | string |
sendFailedTo | string <email> If present, send emails for failed tasks to this email address. |
{- "nantomicsVcfFileId": "string",
- "datasetId": "string",
- "outputFilePrefix": "string",
- "subjectId": "string",
- "sequenceName": "string",
- "sequenceType": "somatic",
- "performerId": "string",
- "testType": "string",
- "indexedDate": "string",
- "uploadType": "string",
- "useExistingSequence": true,
- "reIngestFile": true,
- "bodySite": "string",
- "bodySiteSystem": "string",
- "bodySiteDisplay": "string",
- "sendFailedTo": "user@example.com"
}
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
Create an Ashion import task.
LifeOmic-Account required | string The LifeOmic account to access. |
nantomicsVcfFileId required | string |
datasetId required | string |
outputFilePrefix required | string |
subjectId required | string |
sequenceName | string |
sequenceType required | string Enum: "somatic" "germline" |
performerId | string |
testType | string |
indexedDate | string |
uploadType | string |
useExistingSequence | boolean |
reIngestFile | boolean |
bodySite | string |
bodySiteSystem | string |
bodySiteDisplay | string |
sendFailedTo | string <email> If present, send emails for failed tasks to this email address. |
{- "nantomicsVcfFileId": "string",
- "datasetId": "string",
- "outputFilePrefix": "string",
- "subjectId": "string",
- "sequenceName": "string",
- "sequenceType": "somatic",
- "performerId": "string",
- "testType": "string",
- "indexedDate": "string",
- "uploadType": "string",
- "useExistingSequence": true,
- "reIngestFile": true,
- "bodySite": "string",
- "bodySiteSystem": "string",
- "bodySiteDisplay": "string",
- "sendFailedTo": "user@example.com"
}
{- "name": "string",
- "datasetId": "string",
- "description": "string",
- "scheduleExpression": "string",
- "scheduleDate": "2019-08-24T14:15:22Z",
- "maxDurationSeconds": 60,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "email": {
- "sendFailedTo": "user@example.com",
- "sendCompletedTo": "user@example.com"
}, - "executors": [
- {
- "image": "string",
- "command": [
- "string"
], - "stdin": "string",
- "stdout": "string",
- "stderr": "string",
- "workdir": "string"
}
], - "resources": {
- "cpu_cores": 1,
- "ram_gb": 180,
- "disk_gb": 5000,
- "preemptible": true
}, - "inputs": [
- {
- "name": "string",
- "description": "string",
- "prefix": "string",
- "roleArn": "string",
- "url": "string",
- "path": "string",
- "type": "FILE"
}
], - "outputs": [
- {
- "host": "string",
- "port": "string",
- "username": "string",
- "password": "string",
- "ciphers": [
- "string"
], - "privateKey": "string",
- "privateKeyPassphrase": "string",
- "remoteFilePath": "string",
- "action": "DELETE",
- "path": "string",
- "type": "SFTP"
}
]
}
Supports clinical trials alerting operations.
For information about Clinical Trials as implemented in the LifeOmic Platform web app, see the Clinical Trials Overview.
Returns a user alert based on id
projectId required | string The LifeOmic project to access |
alertId required | string The alert id |
{- "accountId": "string",
- "projectId": "string",
- "userId": "string",
- "id": "string",
- "trialId": "string",
- "trialName": "string",
- "filterName": "string",
- "createdDate": "string",
- "effect": "Positive",
- "type": "TaggedTrial",
- "cleared": true,
- "trialsAdded": [
- {
- "trialId": "string",
- "title": "string"
}
], - "trialsRemoved": [
- {
- "trialId": "string",
- "title": "string"
}
], - "changes": [
- {
- "field": "string",
- "oldValue": "string",
- "newValue": "string"
}
], - "emailSent": true
}
List user alerts in the specified LifeOmic project with paging
projectId required | string The LifeOmic project to access |
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
{- "items": [
- {
- "accountId": "string",
- "projectId": "string",
- "userId": "string",
- "id": "string",
- "trialId": "string",
- "trialName": "string",
- "filterName": "string",
- "createdDate": "string",
- "effect": "Positive",
- "type": "TaggedTrial",
- "cleared": true,
- "trialsAdded": [
- {
- "trialId": "string",
- "title": "string"
}
], - "trialsRemoved": [
- {
- "trialId": "string",
- "title": "string"
}
], - "changes": [
- {
- "field": "string",
- "oldValue": "string",
- "newValue": "string"
}
], - "emailSent": true
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Gets a list of clinical trial filters that a user is watching in the specified LifeOmic project
projectId required | string The LifeOmic project to access |
{- "accountId": "string",
- "projectId": "string",
- "userId": "string",
- "filters": [
- "string"
]
}
Adds a clinical trial filter to the list of filters that a user is watching in the specified LifeOmic project
projectId required | string The LifeOmic project to access |
filterName required | string The name of the clinical trial filter to watch |
{ }
{- "accountId": "string",
- "projectId": "string",
- "userId": "string",
- "filters": [
- "string"
]
}
Removes a clinical trial filter to the list of filters that a user is watching in the specified LifeOmic project
projectId required | string The LifeOmic project to access |
filterName required | string The name of the clinical trial filter to stop watching |
null
Returns a user tag based on id
projectId required | string The LifeOmic project to access |
tagId required | string The clinical trial tag to return, 13644aa6-0b27-4647-9621-0ed6c269c981 for favorites |
{- "accountId": "string",
- "projectId": "string",
- "userId": "string",
- "id": "string",
- "name": "string",
- "trials": [
- "string"
], - "alertEnabled": true
}
Update the alerting status of a user tag based on id
projectId required | string The LifeOmic project to access |
tagId required | string The clinical trial tag to update, 13644aa6-0b27-4647-9621-0ed6c269c981 for favorites |
alertEnabled required | boolean |
{- "alertEnabled": true
}
{- "accountId": "string",
- "projectId": "string",
- "userId": "string",
- "id": "string",
- "name": "string",
- "trials": [
- "string"
], - "alertEnabled": true
}
Adds the given trial to the specified user tag
projectId required | string The LifeOmic project to access |
tagId required | string The clinical trial tag to add the trial to, 13644aa6-0b27-4647-9621-0ed6c269c981 for favorites |
trialId required | string The id of the trial to add to the tag |
{ }
null
Removes the given trial from the specified user tag
projectId required | string The LifeOmic project to access |
tagId required | string The clinical trial tag to remove the trial from, 13644aa6-0b27-4647-9621-0ed6c269c981 for favorites |
trialId required | string The id of the trial to remove from the tag |
null
Supports the operation of multi-part file uploads where each file is over 5 MBs. Use the Files operations for smaller uploads.
Returns a list of multi-part uploads that the user has access to.
pageSize | number The number of results to return in the request. |
nextPageToken | string The page token used to request a specific page. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "id": "string",
- "name": "string",
- "datasetId": "string",
- "contentType": "string",
- "uploadId": "string"
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Create an multi-part upload operation. Note that each part of the upload must be at least 5 MB in size to use this method. If the file is smaller than this, use the normal file upload resource at /v1/files
. If an id is specified in the request body, then any existing file at that id will be overwritten.
LifeOmic-Account required | string The LifeOmic account to access. |
id | string Id of the resultant file. If provided on POST, then the id must be a V4 UUID, otherwise the server will create a new UUID for the file. |
name | string The file name. |
datasetId | string The project the file belongs to. |
contentType | string The content type of the file. |
uploadId | string The server generated upload ID for the multi-part operation. This field is ignored on POST requests. |
{- "id": "string",
- "name": "string",
- "datasetId": "string",
- "contentType": "string",
- "uploadId": "string"
}
{- "id": "string",
- "name": "string",
- "datasetId": "string",
- "contentType": "string",
- "uploadId": "string"
}
Returns an multi-part upload.
uploadId required | string The upload id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "id": "string",
- "name": "string",
- "datasetId": "string",
- "contentType": "string",
- "uploadId": "string"
}
Completes or aborts a multi-part upload. Upon completion, the file parts are combined in order and the file is ready to be accessed
uploadId required | string The upload id. |
abort | boolean Set to true to abort a multi-part upload operation. |
LifeOmic-Account required | string The LifeOmic account to access. |
null
Returns an upload.
uploadId required | string The upload id. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "items": [
- {
- "eTag": "string",
- "partNumber": 0
}
], - "links": {
- "self": "string",
- "next": "string"
}
}
Get upload URL for part of a multi-part upload operation. Note that part numbers do not have to be consecutive.
uploadId required | string The upload id. |
partNumber required | number The part number. Must be between 1 and 10,000. |
LifeOmic-Account required | string The LifeOmic account to access. |
{- "uploadUrl": "string",
- "partNumber": 0
}