Known Limitations

Annotator for Clinical Data imposes a 50K limit on text being analyzed per request. For JSON requests, the JSON metadata does not count towards the 50K threshold. The Annotator for Clinical Data analyze APIs will return an HTTP 413 Payload Too Large error if the input text exceeds the 50K threshold.

Cartridge deployments via the deploy API can sometimes exceed the one minute timeout threshold for services to provide a response. When the timeout is exceeded, an HTTP 504 Gateway Timeout response is returned in HTML format. Despite the HTTP 504 Gateway Timeout response, the deploy operation will continue to completion. In the event of a deployment timeout, you can verify successful deployment of the cartridge through monitoring the status of the deployment. See Cartridge Deployment.

Use of the asynchronous cartridges APIs is recommended to avoid cartridge deployment timeouts. See here for more information about troubleshooting a cartridge deployment.

While multiple unstructured array elements with text values may be submitted in a single request, 40 unstructured array elements is the recommended limit to avoid performance degradation due to processing overhead.

When a cartridge is in the midst of being deployed or re-deployed, use of the flows therein for text analysis should be avoided until cartridge deployment has successfully completed. Use of cartridge flows while the cartridge is actively being deployed may yield unexpected results.