Signals Notebook: Retrieving Entities that are created from a specific System Template via API

Since Signals Notebook v24.4, you can search entities (Experiments, Tables etc.) that are created from a specific System Template by using the filter “Origin Template” on the Signals Notebook GUI.

This article shows how to do the same search by Signals Notebook API.

API and Search Parameter

You can use the following API and the request body to retrieve a list of Entities that are derived from the System Template identified by "<Template EID>"

• Method and Path: POST /api/rest/v1.0/entities/search
• Request Body: (please replace "<Template EID>" with a real template EID in the sample JSON below.)

{
  "query": {
    "$match": {
      "field": "system.Origin Template",
      "in": "tags",
      "value": "<Template EID>",
      "mode": "keyword"
    }
  }
}

Sample Call

For example, if you want to search Experiments that were derived from the Experiment Template "experiment:e647f6e1-98c1-487a-b0a0-41df1b039b1e", you can call the API below. Note that it uses an option and parameters to sort the list in "modifiedAt" descending order and limit the maximum number of returned Entities to 100.

POST /api/rest/v1.0/entities/search?source=SN&page[offset]=0&page[limit]=100

{
  "query": {
    "$match": {
      "field": "system.Origin Template",
      "in": "tags",
      "value": "experiment:e647f6e1-98c1-487a-b0a0-41df1b039b1e",
      "mode": "keyword"
    }
  },
  "options": {
    "sort": {
      "modifiedAt": "desc"
    }
  }
}

For More Information

How to test calling APIs on the API Document (Swagger page)

You can test the APIs from the web GUI on Signals Notebook. 

Knowledge base: Signals Notebook: How to access API documentation?

More about Query Language

Our Admin Guide explains the grammar of the query language by providing examples. Please open "Signals Configuration" app, and find the section "Query Operators in Search APIs". You will find detailed information about operators, fields and options that can be used in queries.