Sign in

v1

latestOpenAPI 3.0.02026-07-17101229.1 KB
GA4GH

List all tools

This endpoint returns all tools available or a filtered subset using metadata query parameters.

get/tools

Query parameters

idstring

A unique identifier of the tool, scoped to this registry, for example 123456.

aliasstring

Support for this parameter is optional for tool registries that support aliases. If provided will only return entries with the given alias.

toolClassstring

Filter tools by the name of the subclass (#/definitions/ToolClass)

descriptorType'CWL' | 'WDL' | 'NFL' | 'GALAXY' | 'SMK'

The type of descriptor that represents this version of the tool. Note that these files can also include associated Docker/container files and test parameters that further describe a version of a tool.

Filter tools by the name of the descriptor type

tagsstring[]

Filter tools by registry specific tags

registrystring

The image registry that contains the image.

organizationstring

The organization in the registry that published the image.

namestring

The name of the image.

toolnamestring

The name of the tool.

descriptionstring

The description of the tool.

authorstring

The author of the tool (TODO a thought occurs, are we assuming that the author of the CWL and the image are the same?).

checkerboolean

Return only checker workflows.

offsetstring

Start index of paging. Pagination results can be based on numbers or other values chosen by the registry implementor (for example, SHA values). If this exceeds the current result set return an empty set. If not specified in the request, this will start at the beginning of the results.

limitinteger

Amount of records to return in a given page.

Response

An array of Tools that match the filter.

urlstring required

The URL for this tool in this registry.

idstring required

A unique identifier of the tool, scoped to this registry.

aliasesstring[]

Support for this parameter is optional for tool registries that support aliases. A list of strings that can be used to identify this tool which could be straight up URLs. This can be used to expose alternative ids (such as GUIDs) for a tool for registries. Can be used to match tools across registries.

organizationstring required

The organization that published the image.

namestring

The name of the tool.

descriptionstring

The description of the tool.

meta_versionstring

The version of this tool in the registry. Iterates when fields like the description, author, etc. are updated.

has_checkerboolean

Whether this tool has a checker tool associated with it.

checker_urlstring

Optional url to the checker tool that will exit successfully if this tool produced the expected result given test data.

Example response

[
  {
    "url": "http://agora.broadinstitute.org/tools/123456",
    "versions": [
      {
        "url": "http://agora.broadinstitute.org/tools/123456/versions/1",
        "id": "v1",
        "images": [
          {
            "checksum": [
              {
                "checksum": "77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182",
                "type": "sha256"
              }
            ]
          }
        ],
        "included_apps": [
          "https://bio.tools/tool/mytum.de/SNAP2/1",
          "https://bio.tools/bioexcel_seqqc"
        ]
      }
    ]
  }
]