Airbyte Cloud Jobs Reset

Airbyte Cloud Jobs Reset

Certified

Run an Airbyte Cloud reset

Starts a reset job for an Airbyte Cloud connection. By default, the task waits for completion and emits job metrics.

The task also exposes the connection that ran the job, a connectionSnapshot file (connector configurations are never included) and a jobUrl to the job in Airbyte Cloud. A reset clears data, so it declares no assets.

Breaking change: this task now fails when the Airbyte job ends FAILED or CANCELLED. The outputs stay available: use allowFailure: true or an errors branch to keep the previous behavior.

Per-stream and per-attempt statistics, the attempts output and onPartialSuccess are not available on Airbyte Cloud, because its public API only reports bytesSynced, rowsSynced and duration for a job.

yaml
type: io.kestra.plugin.airbyte.cloud.jobs.Reset
yaml
id: airbyte_reset
namespace: company.team

tasks:
  - id: reset
    type: io.kestra.plugin.airbyte.cloud.jobs.Reset
    token: "{{ secret('AIRBYTE_TOKEN') }}"
    connectionId: e3b1ce92-547c-436f-b1e8-23b6936c12cd
Installation

Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command: 

kestractl plugins get io.kestra.plugin:plugin-airbyte --compatible-for $KESTRA_VERSION

For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.

For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.

Properties

Connection ID

Airbyte Cloud connection ID for the job

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

Client ID

Airbyte application client ID used for client-credentials authentication

Client secret

Airbyte application client secret used for client-credentials authentication. Store this value in a Secret

DefaultPT1H

Maximum wait duration

Maximum total time to wait for the job to finish, including Airbyte's automatic retry attempts. Defaults to 60 minutes

Basic auth password

Password for Airbyte Cloud basic authentication. Store this value in a Secret

DefaultPT1S

Poll frequency

Interval between Airbyte Cloud job status checks. Defaults to 1 second

Bearer token

Bearer token for the Airbyte Cloud API. If this is set, it is used before client credentials or basic auth

Defaulthttps://api.airbyte.com/v1/applications/token

Token URL

Token endpoint used with client credentials. Defaults to https://api.airbyte.com/v1/applications/token. See: https://reference.airbyte.com/reference/createaccesstoken

Basic auth username

Username for Airbyte Cloud basic authentication. Basic auth is used only when no bearer token or client credentials are configured

Defaulttrue

Wait for completion

If true, wait for the Airbyte Cloud job to reach a terminal state before the task completes. Defaults to true

Connection

Summary of the connection, source and destination of the job. null when their configuration could not be read

Definitions

Short, non-secret description of the connection that ran the job

connectionIdstring

Connection ID

destinationIdstring

Destination ID

destinationNamestring

Destination name

Name given to the destination in Airbyte

destinationTypestring

Destination type

Destination connector type, for example Snowflake

namestring

Name

scheduleTypestring

Schedule type

sourceIdstring

Source ID

sourceNamestring

Source name

Name given to the source in Airbyte

sourceTypestring

Source type

Source connector type, for example Postgres

statusstring

Status

streamCountinteger

Selected stream count

Number of streams replicated by the connection

workspaceIdstring

Workspace ID

Formaturi

Connection snapshot file

Internal storage URI of a JSON file with the connection, source and destination configuration at the time of the job. Connector configurations are never included. null when it could not be read

Job details

Airbyte Cloud job returned by the task

Definitions
bytesSyncedinteger

Bytes synced

Number of bytes synced by the job

durationstring
Formatduration

Duration

Total duration of the job

jobIdinteger

Job ID

Airbyte Cloud job ID

jobTypestring
Possible Values
SYNCRESETREFRESHCLEAR

Job type

Type of job (e.g. SYNC or RESET)

lastUpdatedAtstring
Formatdate-time

Last updated at

Timestamp when the job was last updated

rowsSyncedinteger

Rows synced

Number of rows synced by the job

startTimestring
Formatdate-time

Start time

Timestamp when the job started

statusstring
Possible Values
PENDINGRUNNINGINCOMPLETEFAILEDSUCCEEDEDCANCELLED

Status

Job status. Terminal when wait is enabled

Job URL

Link to the job in the Airbyte Cloud web app. null when the workspace could not be resolved

More Plugins in this Category

Dataform
Dataform

Tasks that run Dataform data transformations through the Dataform CLI.

Data

1 tasks

6 blueprints

Huawei
Huawei

Huawei plugin for Kestra

CloudDataInfrastructure

45 tasks

6 blueprints