You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix(integrations): build fix, doc accuracy, and comment cleanup
- google-docs: align manualDocumentId condition with the document selector so the documentId canonical group has matching conditions (fixes canonical-pair block test / build)
- microsoft-excel: describe fill/font color as hex code only (Graph does not reliably accept named colors)
- remove verbose explanatory inline comments from new tools (keep idiomatic section dividers)
- regenerate integration docs + integrations.json catalog from the block registry
Copy file name to clipboardExpand all lines: apps/docs/content/docs/en/integrations/airtable.mdx
+53-1Lines changed: 53 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ In Sim, the Airtable integration enables your agents to interact with your Airta
26
26
27
27
## Usage Instructions
28
28
29
-
Integrates Airtable into the workflow. Can list bases, list tables (with schema), and create, get, list, or update records. Can also be used in trigger mode to trigger a workflow when an update is made to an Airtable table.
29
+
Integrates Airtable into the workflow. Can list bases, list tables (with schema), and create, get, list, update, upsert, or delete records. Can also be used in trigger mode to trigger a workflow when an update is made to an Airtable table.
30
30
31
31
32
32
@@ -203,6 +203,58 @@ Update multiple existing records in an Airtable table
203
203
| ↳ `recordCount`| number | Number of records updated |
204
204
| ↳ `updatedRecordIds`| array | List of updated record IDs |
205
205
206
+
### `airtable_upsert_records`
207
+
208
+
Update existing records or create new ones in an Airtable table, matching on the specified merge fields
209
+
210
+
#### Input
211
+
212
+
| Parameter | Type | Required | Description |
213
+
| --------- | ---- | -------- | ----------- |
214
+
|`baseId`| string | Yes | Airtable base ID \(starts with "app", e.g., "appXXXXXXXXXXXXXX"\)|
215
+
|`tableId`| string | Yes | Table ID \(starts with "tbl"\) or table name |
216
+
|`records`| json | Yes | Array of records to upsert, each with a `fields` object |
217
+
|`fieldsToMergeOn`| json | Yes | Array of field names used to match existing records \(max 3\). A record is updated when all merge fields match, otherwise it is created. Example: \["Name"\]|
218
+
|`typecast`| boolean | No | When true, Airtable automatically converts string values to the field type |
219
+
220
+
#### Output
221
+
222
+
| Parameter | Type | Description |
223
+
| --------- | ---- | ----------- |
224
+
|`records`| array | Array of upserted Airtable records |
225
+
| ↳ `id`| string | Record ID |
226
+
| ↳ `createdTime`| string | Record creation timestamp |
227
+
| ↳ `fields`| json | Record field values |
228
+
|`createdRecords`| array | IDs of records that were created |
229
+
|`updatedRecords`| array | IDs of records that were updated |
230
+
|`metadata`| json | Operation metadata |
231
+
| ↳ `recordCount`| number | Total number of records returned |
232
+
| ↳ `createdCount`| number | Number of records created |
233
+
| ↳ `updatedCount`| number | Number of records updated |
234
+
235
+
### `airtable_delete_records`
236
+
237
+
Delete one or more records from an Airtable table by ID
238
+
239
+
#### Input
240
+
241
+
| Parameter | Type | Required | Description |
242
+
| --------- | ---- | -------- | ----------- |
243
+
|`baseId`| string | Yes | Airtable base ID \(starts with "app", e.g., "appXXXXXXXXXXXXXX"\)|
244
+
|`tableId`| string | Yes | Table ID \(starts with "tbl"\) or table name |
245
+
|`recordIds`| json | Yes | Array of record IDs to delete \(each starts with "rec", e.g., \["recXXXXXXXXXXXXXX"\]\). Pass a single-element array to delete one record. |
246
+
247
+
#### Output
248
+
249
+
| Parameter | Type | Description |
250
+
| --------- | ---- | ----------- |
251
+
|`records`| array | Array of deleted Airtable records |
252
+
| ↳ `id`| string | Record ID |
253
+
| ↳ `deleted`| boolean | Whether the record was deleted |
254
+
|`metadata`| json | Operation metadata |
255
+
| ↳ `recordCount`| number | Number of records deleted |
256
+
| ↳ `deletedRecordIds`| array | List of deleted record IDs |
257
+
206
258
### `airtable_get_base_schema`
207
259
208
260
Get the schema of all tables, fields, and views in an Airtable base
0 commit comments