https://github.com/teableio/airtable2teable
migrate from airtable
https://github.com/teableio/airtable2teable
Last synced: about 1 year ago
JSON representation
migrate from airtable
- Host: GitHub
- URL: https://github.com/teableio/airtable2teable
- Owner: teableio
- License: mit
- Created: 2024-02-27T10:59:22.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-03T07:35:00.000Z (over 1 year ago)
- Last Synced: 2025-04-16T04:34:59.768Z (about 1 year ago)
- Language: TypeScript
- Size: 620 KB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# airtable2teable
The data pipeline from airtable to teable.
## Prepare
Airtable's API uses token-based authentication, allowing users to authenticate API requests by inputting their tokens
into the HTTP authorization bearer token header.
Tokens can only access API endpoints covered by the scopes granted to them. Tokens serve as the account of the user who
grants access, with the following limitations:
- Scopes: What actions the token can perform.
- Resources/access: What bases and workspace the token can access. Tokens can be granted access to individual—or
all—bases/workspaces. These can be listed using the list bases endpoint.
To import airtable Base data into a teable Workspace, the token requires the following
Scope: `data.records:read`, `schema.bases:read`.
[Teable - Access Token](https://help.teable.io/developer/api/access-token)
## Quick Start
### Command
```shell
npm install -g @teatool/cmd
npx teatool base:migrate --from --to [--baseUrl ]
Airatable Token:
Teable Token:
```
### GUI
## Dev
```shell
pnpm run build
cd .\packages\bin
# windows
.\bin\dev.cmd base:migrate --from --to [--baseUrl ]
Airatable Token:
Teable Token:
# linux
./bin/dev.js base:migrate --from --to [--baseUrl ]
Airatable Token:
Teable Token:
```
## Reporting Issues
If you encounter any problems while using this tool, please open an issue in our GitHub repository. When reporting an issue, it's helpful to provide a minimal, reproducible example. This allows us to better understand and address the problem. Your detailed feedback helps improve the tool for everyone.