Skip to content

Listing templates

Dilshat edited this page May 22, 2018 · 10 revisions

List templates ../list

This REST is used to list templates (empty array [] must be returned if no matching templates found ). It has optional parameters that are used to filter the result set. We have the following combinations:

  1. ../list
  2. ../list?owner={owner}
  3. ../list?token={token}
  4. ../list?owner={owner}&token={token}

Listing is performed in this way:

  1. Lists all public templates of all users
  2. Lists all public templates of the specified owner
  3. Lists all public templates of all users + private templates of the token holder + the templates shared with the token holder
  4. Lists all public templates of the specified owner + the private templates of the specified owner that are shared with the token holder

Result set must contain only unique templates and not allow duplicates. That means if a template fits several criteria based on the passed parameters, it must be included into the result set only once.

Note: if name or version parameter is passed, it is used to further filter the result set by the supplied name/version.