API Cookbook

API Cookbook

Syndeia 3.7.1 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.1 (2026-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

  1. JupyterLab is up and running in your environment (e.g. local machine). See here for details.

  2. Syndeia Cloud 3.7 (or 3.7.x) 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.

  3. Download the following from the Syndeia Downloads page that was provided to you in response to your license/download request on our helpdesk

    1. Syndeia Cloud Python client

      1. syndeia_cloud_37x_client_sdk-3.7.1-py_0.tar.bz2

      2. syndeia_cloud_37x_client_sdk-3.7.1-py_0_docs.zip

    2. Syndeia Cloud API and Pipelines Cookbook

      1. Syndeia_Cloud_3.7.1_API_and_Pipelines_Cookbook.zip

  4. Review the Syndeia Cloud API Overview page in your Syndeia Cloud Web Dashboard. See here for details.

  5. 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 and Pipelines Cookbook zip.

(3) Open the API_Cookbook sub-folder, and you will see the following Jupyter notebooks included with this release, organized in folders.

API Cookbook Folder / File

Description

API Cookbook Folder / File

Description

General

 

  • Hello_Syndeia_Cloud.ipynb

This Notebook provides a gentle introduction to using the Syndeia Cloud API.

  • Syndeia_Cloud_Dash_Analytics.ipynb

This Notebook builds on the above notebook and provides examples of analytics.

  • Syndeia_Cloud_OAuth2.ipynbNEW in 3.7.1

This Notebook introduces the use of the OAuth2 Device Code flow with the Syndeia REST API

  • Syndeia_Cloud_Pipelines_API.ipynb NEW in 3.7.1

This Notebook demonstrates the use of the Syndeia REST API to view and execute Pipelines.

Azure_DevOps

 

  • Syndeia_Cloud_Azure_DevOps.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Azure DevOps repositories

  • Syndeia_Cloud_Azure_DevOps_Artifact_Relation_CRUD.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Azure DevOps repositories

Codebeamer

 

  • Syndeia_Cloud_Codebeamer.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Codebeamer repositories

  • Syndeia_Cloud_Codebeamer_Artifact_Relation_CRUD.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Codebeamer repositories

DOORS-NG

 

  • Syndeia_Cloud_DOORS-NG_Regular_Projects.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from regular (non-CM enabled) projects in DOORS-NG

  • Syndeia_Cloud_DOORS-NG_CM_Enabled_Projects.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from CM-enabled projects in DOORS-NG

GENESYS

 

  • Syndeia_Cloud_GENESYS.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from GENESYS Repositories

Jama

 

  • Syndeia_Cloud_Jama.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Jama Connect repositories.

  • Syndeia_Cloud_Jama_Artifact_Relation_CRUD.ipynb NEW in 3.7.1

This Notebook demonstrates the use of Syndeia Cloud API to create and update data in Jama Connect repositories.

  • Syndeia_Cloud_Jama_OAUTH.ipynb
    NEW in 3.7.1

This Notebook demonstrates the use of Syndeia Cloud API to connect with Jama Connect using OAuth.

Jira

 

  • Syndeia_Cloud_Jira.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Jira repositories

  • Syndeia_Cloud_Jira_Artifact_Relation_CRUD.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Jira repositories

Polarion

 

  • Syndeia_Cloud_Polarion.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Polarion repositories

  • Syndeia_Cloud_Polarion_Artifact_Relation_CRUD.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Polarion repositories

SOLIDWORKS_PDM

 

  • Syndeia_Cloud_SOLIDWORKS_PDM.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Solidworks PDM Pro repositories

Teamcenter

 

  • Syndeia_Cloud_Teamcenter.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Teamcenter repositories

  • Syndeia_Cloud_Teamcenter_Artifact_Relation_CRUD.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to create and modify items in Teamcenter repositories

Teamwork_Cloud

 

  • Syndeia_Cloud_Teamwork_Cloud.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Teamwork Cloud repositories

  • Syndeia_Cloud_TWC_Artifact_Properties_Stereotypes.ipynb NEW in 3.7.1

This Notebook demonstrates the use of the Syndeia Cloud API to retrieve the properties and stereotype tags of Teamwork Cloud artifacts.

  • Syndeia_Cloud_TWC_Artifact_Relations.ipynb NEW in 3.7.1

This Notebook demonstrates the use of the Syndeia Cloud API to retrieve the relations of Teamwork Cloud artifacts.

  • Syndeia_Cloud_TWC_Artifacts.ipynb NEW in 3.7.1

This Notebook demonstrates the use of the Syndeia Cloud API to retrieve Teamwork Cloud artifacts.

TestRail

 

  • Syndeia_Cloud_TestRail.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from TestRail repositories

Windchill

 

  • Syndeia_Cloud_Windchill.ipynb

This Notebook demonstrates the use of Syndeia Cloud API to fetch data from Windchill repositories

  • Syndeia_Cloud_Windchill_Artifact_Relation_CRUD.ipynb

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 General / Hello_Syndeia_Cloud.ipynb notebook in JupyterLab and run each cell.

Example

Figure 1 below shows a snippet from the General / 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.

image-20251214-122850.png
Figure 1 - Example of data display from Syndeia_Cloud_Dash_Analytics.ipynb