{ "openapi": "3.0.1", "info": { "title": "Airtable API - Database & Records Automation", "description": "Automate your Airtable bases with the official API. List, create, update, and delete records. Manage tables and fields. Sync data between Airtable and other systems. Perfect for CRM automation, inventory management, project tracking, and data pipelines.", "version": "1.0", "x-build-id": "tQKB6M1nejuXyoXRg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~airtable-api---database-records-automation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-airtable-api---database-records-automation", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/alizarin_refrigerator-owner~airtable-api---database-records-automation/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-airtable-api---database-records-automation", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/alizarin_refrigerator-owner~airtable-api---database-records-automation/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-airtable-api---database-records-automation", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "task" ], "properties": { "task": { "title": "Task", "enum": [ "list_records", "get_record", "create_record", "update_record", "delete_record", "list_tables", "get_table", "create_table", "list_fields", "create_field", "update_field", "list_bases", "get_base", "batch_create_records", "batch_update_records", "batch_delete_records" ], "type": "string", "description": "Operation to perform", "default": "list_records" }, "accessToken": { "title": "Personal Access Token", "type": "string", "description": "Airtable personal access token (from airtable.com/create/tokens)" }, "baseId": { "title": "Base ID", "type": "string", "description": "Airtable base ID (starts with 'app')" }, "tableIdOrName": { "title": "Table ID or Name", "type": "string", "description": "Table ID (starts with 'tbl') or table name" }, "recordId": { "title": "Record ID", "type": "string", "description": "Record ID for get/update/delete operations (starts with 'rec')" }, "fieldId": { "title": "Field ID", "type": "string", "description": "Field ID for field operations (starts with 'fld')" }, "fields": { "title": "Record Fields", "type": "object", "description": "Fields object for create/update record operations (JSON)", "default": {} }, "filterByFormula": { "title": "Filter Formula", "type": "string", "description": "Airtable formula to filter records (e.g., \"{Status} = 'Active'\")" }, "sort": { "title": "Sort Configuration", "type": "array", "description": "Sort records by fields (JSON array: [{field: 'Name', direction: 'asc'}])", "default": [] }, "view": { "title": "View Name or ID", "type": "string", "description": "Airtable view to use for listing records" }, "maxRecords": { "title": "Max Records", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of records to return", "default": 100 }, "tableName": { "title": "Table Name", "type": "string", "description": "Name for new table" }, "tableDescription": { "title": "Table Description", "type": "string", "description": "Description for new table" }, "tableFields": { "title": "Table Fields", "type": "array", "description": "Fields schema for new table (JSON array)", "default": [] }, "fieldName": { "title": "Field Name", "type": "string", "description": "Name for new field" }, "fieldType": { "title": "Field Type", "enum": [ "singleLineText", "multilineText", "number", "currency", "percent", "date", "dateTime", "email", "url", "phoneNumber", "checkbox", "singleSelect", "multipleSelects", "rating", "duration", "richText" ], "type": "string", "description": "Type for new field" }, "fieldOptions": { "title": "Field Options", "type": "object", "description": "Additional options for field (JSON)", "default": {} }, "batchRecords": { "title": "Batch Records", "type": "array", "description": "Array of records for batch operations", "default": [] }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to send results to (Zapier, Make, n8n, etc.)" }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run with sample data (no access token required)", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }