For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshoot FHIR

The following table presents solutions to common issues with the FHIR integration. For additional help, see the official FHIR documentation.

Issue
Cause
What to do

You weren't authorized to perform a FHIR action step in the Agentic Workflow.

Either you didn't create an access token, or your token has expired.

Confirm that your Agentic Workflow begins with the FHIR Authenticate action. Re-run the Agentic Workflow.

You received a single page of search results from the FHIR Search action.

This is expected behavior. The FHIR Search action returns the first page of results only.

Use _count to control the page size of the results. Add logic to the Agentic Workflow to handle pagination manually.

A FHIR Search action in your Agentic Workflow timed out.

An extensive search can exceed the timeout limit of 30 seconds.

Streamline the search.

Your batch import didn't create as many Records in Kizen as you expected.

The maximum payload for a SmartConnector is 256 kilobytes.

Manually prepare multiple smaller batches, and import them into Kizen sequentially.

You added the integration secret, but you received an error message that the secret is missing.

You added the integration secret to the integration configuration, not the Integration Secrets Manager in Kizen.

Add the integration secret to the Integration Secrets Manager. See Set Up FHIR in Kizen for details.


What's Next

To put these troubleshooting tips into better context, see FHIR - Beta for a big-picture discussion about the FHIR integration.


HL7, FHIR, and the FHIR FLAME DESIGN are the registered trademarks of Health Level Seven International, and their use does not constitute endorsement by HL7.

Last updated

Was this helpful?