yaml
type: "io.kestra.plugin.core.http.trigger"
Examples
yaml
id: http_price_alert
namespace: company.team
tasks:
- id: send_slack_alert
type: io.kestra.plugin.notifications.slack.SlackIncomingWebhook
url: "{{ secret('SLACK_WEBHOOK') }}"
payload: |
{
"channel": "#price-alerts",
"text": "The price is now: {{ json(trigger.body).price }}"
}
triggers:
- id: http
type: io.kestra.plugin.core.http.Trigger
uri: https://fakestoreapi.com/products/1
responseCondition: "{{ json(response.body).price <= 110 }}"
interval: PT30S
stopAfter:
- SUCCESS
yaml
id: http_trigger
namespace: company.team
tasks:
- id: log_response
type: io.kestra.plugin.core.log.Log
message: '{{ trigger.body }}'
triggers:
- id: http
type: io.kestra.plugin.core.http.Trigger
uri: https://api.chucknorris.io/jokes/random
responseCondition: "{{ response.statusCode == 200 }}"
stopAfter:
- SUCCESS
Properties
uri *Requiredstring
body string
conditions Non-dynamicDateTimeBetweenDayWeekDayWeekInMonthExecutionFlowExecutionLabelsExecutionNamespaceExecutionOutputsExecutionStatusExpressionFlowConditionFlowNamespaceConditionHasRetryAttemptMultipleConditionNotOrPublicHolidayTimeBetweenWeekend
contentType string
Default
application/json
encryptBody booleanstring
Default
false
formData object
headers object
SubType string
interval Non-dynamicstring
Default
PT1M
Format
duration
method string
Default
GET
options Non-dynamicHttpConfiguration
responseCondition string
Default
{{ response.statusCode < 400 }}
stopAfter Non-dynamicarray
SubType string
Possible Values
CREATED
RUNNING
PAUSED
RESTARTED
KILLING
SUCCESS
WARNING
FAILED
KILLED
CANCELLED
QUEUED
RETRYING
RETRIED
SKIPPED
BREAKPOINT
Outputs
body object
code integer
encryptedBody string
formData object
headers object
SubType array
uri string
Format
uri
Definitions
io.kestra.core.http.client.configurations.TimeoutConfiguration
connectTimeout string
Format
duration
readIdleTimeout string
Default
PT5M
Format
duration
io.kestra.core.models.triggers.TimeWindow
deadline string
Format
partial-time
endTime string
Format
partial-time
startTime string
Format
partial-time
type string
Default
DURATION_WINDOW
Possible Values
DAILY_TIME_DEADLINE
DAILY_TIME_WINDOW
DURATION_WINDOW
SLIDING_WINDOW
window string
Format
duration
windowAdvance string
Format
duration
io.kestra.core.http.client.configurations.ProxyConfiguration
address string
password string
port integerstring
type string
Default
DIRECT
Possible Values
DIRECT
HTTP
SOCKS
username string
Condition to allow events on weekend.
type *Requiredobject
date string
Default
{{ trigger.date }}
Condition to have at least one condition validated.
Condition for an execution namespace.
namespace *Requiredstring
type *Requiredobject
comparison string
Possible Values
EQUALS
PREFIX
SUFFIX
prefix booleanstring
Default
false
java.nio.charset.Charset
io.kestra.core.http.client.configurations.HttpConfiguration
allowFailed booleanstring
Default
false
allowedResponseCodes array
SubType integer
defaultCharset Charsetstring
Default
UTF-8
followRedirects booleanstring
Default
true
logs array
SubType string
Possible Values
REQUEST_HEADERS
REQUEST_BODY
RESPONSE_HEADERS
RESPONSE_BODY
proxy ProxyConfiguration
ssl SslOptions
timeout TimeoutConfiguration
Condition to exclude other conditions.
Condition to execute tasks on a specific day of the week relative to the current month (first, last, ...)
dayInMonth *Requiredstring
Possible Values
FIRST
LAST
SECOND
THIRD
FOURTH
dayOfWeek *Requiredstring
Possible Values
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY
type *Requiredobject
date string
Default
{{ trigger.date }}
Condition to allow events between two specific datetime values.
type *Requiredobject
after string
Format
date-time
before string
Format
date-time
date string
Default
{{ trigger.date }}
Condition that matches if any taskRun has retry attempts.
type *Requiredobject
in array
SubType string
Possible Values
CREATED
RUNNING
PAUSED
RESTARTED
KILLING
SUCCESS
WARNING
FAILED
KILLED
CANCELLED
QUEUED
RETRYING
RETRIED
SKIPPED
BREAKPOINT
notIn array
SubType string
Possible Values
CREATED
RUNNING
PAUSED
RESTARTED
KILLING
SUCCESS
WARNING
FAILED
KILLED
CANCELLED
QUEUED
RETRYING
RETRIED
SKIPPED
BREAKPOINT
io.kestra.core.http.client.configurations.BearerAuthConfiguration
type *Requiredobject
token string
Condition for a specific flow of an execution.
flowId *Requiredstring
namespace *Requiredstring
type *Requiredobject
io.kestra.core.http.client.configurations.BasicAuthConfiguration
type *Requiredobject
password string
username string
Condition for a flow namespace.
namespace *Requiredstring
type *Requiredobject
prefix boolean
Default
false
Condition for a specific flow. Note that this condition is deprecated, use `io.kestra.plugin.core.condition.ExecutionFlow` instead.
flowId *Requiredstring
namespace *Requiredstring
type *Requiredobject
Condition to allow events between two specific times.
type *Requiredobject
after string
Format
time
before string
Format
time
date string
Default
{{ trigger.date }}
Condition that checks labels of an execution.
labels *Requiredarrayobject
type *Requiredobject
io.kestra.core.http.client.configurations.SslOptions
insecureTrustAllCertificates booleanstring
Condition based on the outputs of an upstream execution.
expression *Requiredbooleanstring
type *Requiredobject
Run a flow if the list of preconditions is met in a time window.
id *Requiredstring
Validation RegExp
^[a-zA-Z0-9][a-zA-Z0-9_-]*
Min length
1
type *Requiredobject
resetOnSuccess boolean
Default
true
timeWindow TimeWindow
Default
{
"type": "DURATION_WINDOW"
}
Condition based on variable expression.
expression *Requiredstring
type *Requiredobject
Condition to allow events on a particular day of the week.
dayOfWeek *Requiredstring
Possible Values
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY
type *Requiredobject
date string
Default
{{ trigger.date }}
Condition based on execution status.
type *Requiredobject
in array
SubType string
Possible Values
CREATED
RUNNING
PAUSED
RESTARTED
KILLING
SUCCESS
WARNING
FAILED
KILLED
CANCELLED
QUEUED
RETRYING
RETRIED
SKIPPED
BREAKPOINT
notIn array
SubType string
Possible Values
CREATED
RUNNING
PAUSED
RESTARTED
KILLING
SUCCESS
WARNING
FAILED
KILLED
CANCELLED
QUEUED
RETRYING
RETRIED
SKIPPED
BREAKPOINT
Condition to allow events on public holidays.
type *Requiredobject
country string
date string
Default
{{ trigger.date }}