A key feature of One Codex is the ability to retrieve a structured, machine-readable version of the results of your workflow over our REST API. All of our One Codex analyses provide this JSON result representation by default, and we’ve made it easy for you to include the same functionality in your workflows. All you need to do is output a file namedDocumentation Index
Fetch the complete documentation index at: https://developer.onecodex.com/llms.txt
Use this file to discover all available pages before exploring further.
results.json with a valid, JSON-encoded representation of your analysis results at the top level of the working directory. When your workflow completes, we will automatically search for this file, and if found we’ll parse the contents and make them accessible to you via the /api/v1/analyses/<analysis uuid>/results API route.
At the moment, your
results.json file can contain any JSON object you’d like. We don’t validate the contents of the JSON, just that it is valid JSON. That means you can feel free to follow whatever schema you’d like.In the future, we will offer particular schema definitions that will let us e.g. provide you with more enhanced, dynamic results visualizations for your workflows. Once we release those, we’ll give you the option to opt-in to having your results.jsonfile validated against those schemas. But for now, let your imagination run wild!What’s next? Learn how outputs are made available.