Sent ListTemplates

Sent ListTemplates

Certified

List Sent templates

Lists and automatically paginates templates, with optional search, status, and category filters.

yaml
type: io.kestra.plugin.sent.templates.ListTemplates

List approved templates

yaml
id: sent_templates
namespace: company.messaging

tasks:
  - id: list_templates
    type: io.kestra.plugin.sent.templates.ListTemplates
    apiKey: "{{ secret('SENT_API_KEY') }}"
    status: approved
    fetchType: FETCH
Properties

Sent API key

API key sent in the x-api-key header. Store it as a Kestra secret.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Defaulthttps://api.sent.dm/v3

Sent API base URL

Sent API v3 origin. Keep the default in production. Custom HTTPS origins are intended for controlled proxies; plain HTTP is accepted only for loopback test servers.

Category

Optional Sent template-category filter.

DefaultPT10S

Connection timeout

Maximum time allowed to establish the Sent API connection.

DefaultSTORE
Possible Values
STOREFETCHFETCH_ONENONE

Fetch type

Defaults to STORE to avoid large execution outputs. FETCH_ONE returns the first resource, FETCH returns all resources, STORE streams all resources to internal storage, and NONE returns only the count.

DefaultPT1S

Initial retry interval

Initial exponential-backoff delay for retry-safe transient failures.

Default3

Maximum request attempts

Total attempts for retry-safe calls. GET requests are retry-safe; mutations retry only when an idempotency key is present.

Default1000

Maximum pages

Safety limit that prevents an unbounded pagination loop.

DefaultPT30S

Maximum retry interval

Upper bound for exponential backoff and provider Retry-After delays.

Default1

Starting page

First Sent page to fetch, starting at 1.

Default100

Page size

Resources requested per Sent API page, from 1 to 100.

Sender Profile ID

Optional Sender Profile UUID for x-profile-id scoping with an organization API key. Profile API keys must leave this unset.

DefaultPT30S

Read timeout

Maximum idle time while reading a Sent API response.

Status

Optional Sent template-status filter.

First fetched Sent resource

Populated only with fetchType: FETCH_ONE.

SubTypeobject

Fetched Sent resources

Populated only with fetchType: FETCH.

Fetched resource count

Formaturi

Stored resource URI

Kestra internal-storage URI populated only with fetchType: STORE.