API Cookbook
Syndeia 3.7 offers an updated release of the Syndeia Cloud API Cookbook, a collection of demonstration examples and patterns for using the Syndeia Cloud REST API. The package includes a collection of Jupyter notebooks using the Python client of the Syndeia Cloud REST API. The notebooks demonstrate using Syndeia Cloud API to (1) connect, query, and fetch data from integrated repositories, e.g. Jira, Jama Connect, and Teamwork Cloud; and (2) build and query digital thread for a system where artifacts from multiple repositories are connected together. The Python client for the Syndeia Cloud API is available as a Conda package.
Version
The latest release of the Syndeia Cloud API Cookbook is 3.7 (2025-12). We release new versions of the API Cookbook on a regular basis. Each version includes new (and updates to existing) demonstrations and examples. The Syndeia Cloud API Cookbook package version indicates the Syndeia Cloud API version (3.7) and the release version of the cookbook.
Pre-requisites
JupyterLab is up and running in your environment (e.g. local machine). See here for details.
Syndeia Cloud 3.7 is up and running in your enterprise environment and accessible to you. You should be able to log in to Syndeia Cloud Web Dashboard with your username and password.
Download the following from the Syndeia Downloads page that was provided to you in response to your license/download request on our helpdesk
Syndeia Cloud Python client
syndeia_cloud_37x_client_sdk-3.7-py_0.tar.bz2syndeia_cloud_37x_client_sdk-3.7-py_0_docs.zip
Syndeia Cloud API Cookbook
Syndeia_Cloud_3.7.0_API_Cookbook_2025-12.zip
Review the Syndeia Cloud API Overview page in your Syndeia Cloud Web Dashboard. See here for details.
Review the Syndeia Cloud Swagger doc in your Syndeia Cloud Web Dashboard. See here for details.
Getting Started
(1) Install the Syndeia Cloud Python Client as described here.
(2) Unzip the Syndeia Cloud API Cookbook.
(3) Open the Notebooks directory, you will see the following Jupyter notebooks included with this release
API Cookbook Directory/File | Description |
|---|---|
General |
|
| This Notebook provides a gentle introduction to using the Syndeia Cloud API. |
| This Notebook builds on the above notebook and provides examples of analytics. |
Azure_DevOps |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Azure DevOps repositories |
| This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Azure DevOps repositories |
Codebeamer |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Codebeamer repositories |
| This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Codebeamer repositories |
DOORS-NG |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from regular (non-CM enabled) projects in DOORS-NG |
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from CM-enabled projects in DOORS-NG |
GENESYS |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from GENESYS Repositories |
Jama |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Jama Connect repositories |
Jira |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Jira repositories |
| This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Jira repositories |
Polarion |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Polarion repositories |
| This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Polarion repositories |
SOLIDWORKS_PDM |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Solidworks PDM Pro repositories |
Teamcenter |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Teamcenter repositories |
| This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Teamcenter repositories |
Teamwork_Cloud |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Teamwork Cloud repositories |
TestRail |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from TestRail repositories |
Windchill |
|
| This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Windchill repositories |
| This Notebook demonstrates the use of Syndeia Cloud API to create and update items in Windchill repositories |
(4) You may need to install several Data Science libraries into your chosen python Conda environment. We know that at least the following are likely. Install all reported missing imports, as needed.
conda install pandas
conda install plotly
conda install jinja2
conda install nbformat(5) Open the Hello_Syndeia_Cloud.ipynb notebook in JupyterLab and run each cell.
Example
Figure 1 below shows a snippet from the General / Notebooks / Syndeia_Cloud_Dash_Analytics.ipynbJupyter (ipynb) notebook in the Syndeia Cloud API Cookbook. It shows a table of Jira issues linked to other artifacts (e.g. SysML, Teamcenter, Jama Connect, and other repos) in a Spacecraft Digital Thread Project. The color coding in based on the status of the Jira issues.
Syndeia_Cloud_Dash_Analytics.ipynb