PluginsPlugin Airtable

Delete​Delete

Delete a record from an Airtable table

Delete a specific record by its ID from an Airtable table. This operation cannot be undone.

yaml
type: "io.kestra.plugin.airtable.records.Delete"

Delete a completed task

yaml
id: delete_completed_task
namespace: company.airtable

tasks:
  - id: delete_task
    type: io.kestra.plugin.airtable.records.Delete
    baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
    tableId: "Tasks"
    recordId: "recXXXXXXXXXXXXXX"
    apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"

Delete record from workflow output

yaml
id: delete_from_previous_output
namespace: company.airtable

tasks:
  - id: find_record_to_delete
    type: io.kestra.plugin.airtable.records.List
    baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
    tableId: "Temporary"
    apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"
    filterByFormula: "{Status} = 'To Delete'"
    fetchType: FETCH_ONE

  - id: delete_found_record
    type: io.kestra.plugin.airtable.records.Delete
    baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
    tableId: "Temporary"
    recordId: "{{ outputs.find_record_to_delete.row.id }}"
    apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"

Delete with confirmation using If flow

yaml
id: delete_with_confirmation
namespace: company.airtable

inputs:
  - id: confirm_delete
    type: STRING
    required: true
  - id: order_id
    type: STRING
    required: true

tasks:
  - id: confirm_deletion
    type: io.kestra.plugin.core.flow.If
    condition: "{{ inputs.confirm_delete == 'yes' }}"
    then:
      - id: delete_record
        type: io.kestra.plugin.airtable.records.Delete
        baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
        tableId: "Orders"
        recordId: "{{ inputs.order_id }}"
        apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"
    else:
      - id: skip_deletion
        type: io.kestra.plugin.core.log.Log
        message: "Deletion cancelled - confirmation not provided"
Properties

API key

Airtable API key for authentication

Airtable base ID

The ID of the Airtable base (starts with 'app')

Record ID

The ID of the record to delete (starts with 'rec')

Table ID or name

The ID or name of the table within the base