Portainer icon

Portainer

Interact with Portainer via API

Actions190

Custom Templates → Custom Template List

AI-generated

Overview

This node operation, Custom Template List, retrieves a list of custom templates filtered by specified criteria. It is useful in scenarios where users want to fetch and work with specific types of templates from a system that manages customizable templates, such as deployment configurations, UI components, or automation scripts.

For example, a user might want to list all templates of certain types or only those marked as "edge" templates to quickly find relevant templates for their project or environment.

Properties

Name Meaning
Type Specifies the template types to filter by. Accepts a JSON array of type identifiers.
Additional Fields A collection of optional filters:
- Edge Boolean flag to filter templates by whether they are edge templates (true or false).

Output

The node outputs a JSON array containing the list of custom templates matching the provided filters. Each item in the output represents a template object with its associated properties (not detailed in the source code). The output does not include binary data.

Dependencies

  • Requires an API key credential to authenticate requests.
  • Connects to an external API endpoint configured via credentials, typically requiring a base URL and authentication token.
  • Uses query parameters to send filtering options (type and edge) to the API.

Troubleshooting

  • Empty results: If no templates are returned, verify that the Type property contains valid template types and that the Edge filter matches existing templates.
  • Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Invalid JSON in Type: Since Type expects a JSON array, ensure the input is properly formatted JSON; otherwise, the request may fail or return no results.
  • API connectivity issues: Check network access to the API base URL and confirm the endpoint is reachable.

Links and References

  • No direct links available from the source code.
  • Refer to the API documentation of the service managing custom templates for details on template types and filtering options.

Discussion