Resource APIs


Create Resource

Use this API to upload PDF files and attach them to workflow activities.

This API can only be used to upload PDF files.

HTTP Request

POST /api/v3/resources

Query Parameters

Key Required Description
organizationId yes The organization's internal identifier. (It's the 123 here: https://lab.ovation.io/orgs/123/dashboard.)
requisitionIdentifier yes The Requisition Identifier of the requisition that contains the sample
sampleIdentifier yes The sample's Sample Identifier
resourceGroupName yes The "resource group name," as configured in the workflow's definition. Work with your team at Ovation to properly configure the workflow for use with this API and note this value.
fileContent no The base64-encoded content of file (only used if not requesting upload link)
returnUploadLink no A link to upload the file to S3 (only used if not sending fileContent). If uploading file to S3 make sure the file name starts with sampleIdentifier .

Request Body

{
	"resource": {
		"organizationId": integer,
		"requisitionIdentifier": "string",
		"sampleIdentifier": "string",
		"resourceGroupName": "string",
		"fileContent": "string",
		"returnUploadLink": boolean
  }
}

Response

Response code Response body
201 Indicating the resource was successfully created { message: "Resource #{new_document_name} successfully uploaded." }  or { uploadLink: "https://...." }
401 Indicating an authentication error
422 Indicating an error with the request contents

Will return the validation errors found.

e.g. "Sample not found", "resourceGroupName required"

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.