Smart sync attachments — air_sync_attachments • airtable2

Compares filenames between local data and remote records, uploads new/changed files, skips unchanged.

Usage

air_sync_attachments(
  base_id,
  table,
  field,
  data,
  key,
  parallel = NULL,
  .token = NULL
)

base_id: Base ID (e.g., "appXXXXXX"). If NULL, uses the session default set by air_set_base() or the AIRTABLE_BASE_ID environment variable.
table: Table name or ID.
field: Name of the attachment field.
data: A tibble with a key column and file_path column.
key: Column name that identifies which record to attach to.
parallel: Logical or NULL. If TRUE, attachment downloads use httr2::req_perform_parallel() (up to 5 concurrent). If NULL, uses option airtable2.parallel or env var AIRTABLE2_PARALLEL (default TRUE).
.token: Personal access token (resolved via air_token() if NULL).

A list with counts: uploaded, skipped (invisibly).