Ontoserver Management API
Admin
/api/addBundle
POST
Add a bundle of FHIR Resources to the server
The Bundle supplied in the multipart/form-data must be in either of FHIR's JSON or XML formats.
Request
Content-Type: multipart/form-data
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
file | query | yes | A FHIR Bundle object containing a set of resources | - | ref (application/fhir+json, application/fhir+xml, application/json+fhir, application/xml+fhir, application/json, application/xml) |
Response
Content-Type: application/json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/api/auditReports
GET
Request
Parameters
Response
Content-Type: application/json, application/fhir+json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/api/availableCodeSystemIndexes
GET
Get a list of the code system indexes that are available to this server
Request
Parameters
Response
Content-Type: application/json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation | Array[AtomArtifact] |
/api/availableCodeSystemSources
GET
Get a list of the code system sources that are available to this server
Request
Parameters
Response
Content-Type: application/json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation | Array[AtomArtifact] |
/api/deleteCodeSystem
POST
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
codeSystemId | query | yes | A code system identifier, e.g. http://snomed.info/sct | - | string |
codeSystemVersion | query | yes | The version of the specified code system | - | string |
Response
Status Code | Reason | Response Model |
---|---|---|
default | successful operation | - |
/api/indexCodeSystem
POST
Index a SNOMED/LOINC code system, using a syndication server if available
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
codeSystemId | query | yes | A code system identifier, e.g. http://snomed.info/sct | - | string |
codeSystemVersion | query | no | The version (or optionally, for SNOMED, the Edition) of the specified code system | - | string |
validate | query | yes | Indicates whether the server should validate the index if it already exists | - | boolean |
buildLocal | query | no | Do not use BINARY indexes from syndication feed, but build them locally | - | boolean |
Response
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/api/indexedCodeSystems
GET
Get a list of the code systems that are indexed on this server
Request
Parameters
Response
Content-Type: application/json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation | Array[CodeSystemR4] |
/api/jobs
GET
Retrieve a list of the background Jobs the server has run/is running along with their status
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
jobId | query | no | A job identifier | - | string |
Response
Content-Type: application/json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/api/sct/addRf2
POST
-deprecated- Loads RF2 content into the underlying database. Does not build an index - see /api/indexCodeSystem
Note: under consideration for deprecation
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
file | query | yes | The ZIP file containing RF2 packaged according to IHTSDO conventions | - | ref |
type | query | yes | The release type. One of SCT_RF2_FULL, SCT_RF2_ALL, or SCT_RF2_SNAPSHOT. | - | string |
Response
Content-Type: application/json
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/api/upstream.xml
GET
Retrieve merged form of the server's upstream syndication feeds (if available)
Request
Parameters
Response
Content-Type: application/atom+xml
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
Deprecated
Syndication
/synd/fetchSyndicatedContentEntry
POST
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
entryId | query | no | The atom entry ID to fetch | - | string |
resourceType | query | no | The type of resource to fetch | - | string |
url | query | no | The URL of the resource (CodeSystem, ValueSet, ConceptMap or StructureDefinition) to fetch | - | string |
version | query | no | The version of the resource to fetch | - | string |
bundleInterpretation | query | no | If the entry is a Bundle, how to process the Bundle. Valid values are: 'batch' and 'collection' | - | string |
Response
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/synd/getBinaryIndexZip
GET
Retrieve the binary index for a code system from the server (if available)
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
codeSystemId | query | yes | A code system identifier, e.g. http://snomed.info/sct | - | string |
codeSystemVersion | query | yes | The version of the specified code system | - | string |
indexVersion | query | yes | The internal version of the binary index format | - | string |
Response
Content-Type: application/zip
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation | InputStreamResource |
/synd/getSyndicationStatus
GET
Get the downstream syndication status for a Resource on the server
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
resourceType | query | yes | The type of the resource, e.g. ValueSet, CodeSystem, NamingSystem | - | string |
id | query | yes | The id of the resource | - | string |
Response
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |
/synd/redoPreload
POST
Request
Parameters
Response
Status Code | Reason | Response Model |
---|---|---|
200 | Preload execution has been started | - |
500 | Preload could not be re-executed | - |
/synd/setIndexSyndicationStatus
POST
Change the downstream syndication status for a SNOMED/LOINC code system on the server
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
codeSystemId | query | yes | A code system identifier, e.g. http://snomed.info/sct | - | string |
codeSystemVersion | query | yes | The version of the specified code system | - | string |
syndicate | query | yes | Whether to publish a binary index for the code system | - | boolean |
Response
Status Code | Reason | Response Model |
---|---|---|
default | successful operation | - |
/synd/setSyndicationStatus
POST
Change the downstream syndication status for a Resource on the server
Request
Parameters
Name | Located in | Required | Description | Default | Schema |
---|---|---|---|---|---|
resourceType | query | yes | The type of the resource, e.g. ValueSet, CodeSystem, NamingSystem | - | string |
id | query | yes | The id of the resource | - | string |
syndicate | query | yes | Whether to publish the resource in the downstream syndication feed | - | boolean |
Response
Status Code | Reason | Response Model |
---|---|---|
default | successful operation | - |
/synd/syndication.xml
GET
Retrieve the server's downstream syndication feed (if available)
Request
Parameters
Response
Content-Type: application/atom+xml
Status Code | Reason | Response Model |
---|---|---|
200 | successful operation |