{
"openapi": "3.0.1",
"info": {
"title": "Airtable Base Schema Auditor & Link Checker",
"description": "Audit any Airtable base with a read-only token. Ranked findings for broken formulas, links into empty tables, duplicate field names, text columns holding dates, and invite links that give strangers edit access. Scorecard per base plus a shareable HTML report.",
"version": "1.0",
"x-build-id": "IaNcC3ZaJlJzNuUtm"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/mediocre_interest~airtable-schema-auditor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-mediocre_interest-airtable-schema-auditor",
"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/mediocre_interest~airtable-schema-auditor/runs": {
"post": {
"operationId": "runs-sync-mediocre_interest-airtable-schema-auditor",
"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/mediocre_interest~airtable-schema-auditor/run-sync": {
"post": {
"operationId": "run-sync-mediocre_interest-airtable-schema-auditor",
"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",
"properties": {
"airtableToken": {
"title": "Airtable personal access token",
"type": "string",
"description": "A read-only Airtable personal access token. The whole rule set runs on the single schema.bases:read scope; add data.records:read only if you turn on record sampling below. Create one at airtable.com/create/tokens and grant it the bases you want audited.
Leave this empty to see the Actor work on two bundled sample bases — one deliberately broken, one correctly built — for free, with no Airtable account. Those rows are marked source: \"sample\"."
},
"baseIds": {
"title": "Bases to audit",
"type": "array",
"description": "Airtable base IDs, one per line. Paste the whole base URL if that is easier — the ID is taken out of it. Leave empty to audit every base the token can see.",
"default": [],
"items": {
"type": "string"
}
},
"rulePacks": {
"title": "Rule packs",
"uniqueItems": true,
"type": "array",
"description": "Which families of checks to run. Exposure reads the base's invite links and collaborator metadata (domains and counts only — no email address is ever written to the output). Values needs record sampling turned on below.",
"items": {
"type": "string",
"enum": [
"structure",
"naming",
"links",
"exposure",
"values"
],
"enumTitles": [
"Structure — undocumented tables, oversized selects, precision drift",
"Naming — duplicate and near-duplicate field names",
"Links — broken formulas, orphan tables, unreadable link targets",
"Exposure — open invite links, credentials in descriptions, personal data",
"Values — empty tables, always-empty fields, wrong column types"
]
},
"default": [
"structure",
"naming",
"links",
"exposure",
"values"
]
},
"minSeverity": {
"title": "Minimum severity",
"enum": [
"critical",
"high",
"medium",
"low"
],
"type": "string",
"description": "Drop findings milder than this. Leave it at Low on a first run: the naming and documentation findings are most of what a consultant hands over, and the output view sorts by severity anyway.",
"default": "low"
},
"sampleRecords": {
"title": "Sample records",
"type": "boolean",
"description": "Read a few records per table so the Actor can find empty tables, columns that are never filled in, text columns holding dates or emails, and duplicate values in a primary field. Needs the data.records:read scope on your token. Off by default so the standard run asks for exactly one read-only scope.",
"default": false
},
"sampleSize": {
"title": "Records sampled per table",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "How many records to read from each table. The sample is evidence, not a copy of your data — 100 is enough to tell an always-empty column from a sparse one. Values below 3 disable the wrong-column-type check.",
"default": 100
},
"maxTablesSampled": {
"title": "Maximum tables sampled",
"minimum": 1,
"type": "integer",
"description": "Stop sampling after this many tables per base. Schema checks still cover every table; only the record-based checks stop. Airtable allows up to 1,000 tables in one base, and sampling all of them is one request each.",
"default": 200
},
"includeHtmlReport": {
"title": "Write a shareable HTML report",
"type": "boolean",
"description": "Produce a self-contained web page per base, ranked worst first, ready to send to whoever owns the base. The link appears on that base's scorecard row.",
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}