> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Airtable

> Connect Airtable to your Atako agents — 11 read and 19 write actions.

Let your agents work with your Airtable bases — query and edit records, manage tables, fields, comments and webhooks.

## Connection

* **Authentication**: API key (Personal access token (pat...)).

<Note>
  Airtable → airtable.com/create/tokens → Create new token → name it, add scopes data.records:read, data.records:write, data.recordComments:read, data.recordComments:write, schema.bases:read, schema.bases:write and webhook:manage, grant access to the bases the agent may use, then Create token and copy it (starts with pat).

  See [Airtable's documentation](https://airtable.com/create/tokens).
</Note>

## Read actions (11)

| Action                   | Description                                                                                                 |
| ------------------------ | ----------------------------------------------------------------------------------------------------------- |
| `get_base_collaborators` | Get base info and its collaborators, invite links and interfaces.                                           |
| `get_base_schema`        | Get the schema of a base: its tables, fields and views.                                                     |
| `get_record`             | Fetch a single record by its ID.                                                                            |
| `get_user_info`          | Get the token's user ID and granted scopes.                                                                 |
| `list_bases`             | List the bases the token can access.                                                                        |
| `list_comments`          | List the comments on a record.                                                                              |
| `list_records`           | List records in a table, with optional view, formula filter and pagination.                                 |
| `list_views`             | List the views of a base with their basic metadata.                                                         |
| `list_webhook_payloads`  | List the change payloads emitted by a webhook since a cursor.                                               |
| `list_webhooks`          | List the webhooks registered on a base.                                                                     |
| `query_records`          | Query (list) records in a table with field selection, sorting and long formula filters in the request body. |

## Write actions (19)

| Action                  | Description                                                                  |
| ----------------------- | ---------------------------------------------------------------------------- |
| `batch_create_records`  | Create up to 10 records in a table in one call.                              |
| `batch_delete_records`  | Delete up to 10 records by ID in one call.                                   |
| `batch_replace_records` | Replace up to 10 records entirely in one call (unlisted fields are cleared). |
| `batch_update_records`  | Update up to 10 records in one call, with optional upsert on merge fields.   |
| `create_base`           | Create a base in a workspace with at least one table.                        |
| `create_comment`        | Add a comment on a record, optionally as a reply to another comment.         |
| `create_field`          | Add a field (column) to a table.                                             |
| `create_record`         | Create a single record in a table.                                           |
| `create_table`          | Create a table in a base with an initial set of fields.                      |
| `create_webhook`        | Register a webhook on a base to be notified of data or schema changes.       |
| `delete_comment`        | Delete a comment from a record.                                              |
| `delete_record`         | Delete a single record by its ID.                                            |
| `delete_webhook`        | Delete a webhook from a base.                                                |
| `refresh_webhook`       | Extend the life of a webhook by 7 days before it expires.                    |
| `replace_record`        | Replace a record entirely (fields not given are cleared).                    |
| `update_comment`        | Edit the text of a comment you authored.                                     |
| `update_field`          | Rename a field or change its description.                                    |
| `update_record`         | Update some fields of a record (unlisted fields are left unchanged).         |
| `update_table`          | Rename a table or change its description.                                    |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.