Deletes the specified base. Deleted bases can be restored by workspace owners from the Trash UI, up to the workspace's billing plan retention period.
Workspaces
Delete base
delete
https://api.airtable.com/v0/meta/bases/{baseId}
Authentication | Personal access token, OAuth integration |
Scope | workspacesAndBases:manage |
User role | Enterprise admin Admins of multiple enterprises
should use an enterprise-scoped token or a service account's token when calling this route. |
Billing plans | Enterprise (pre-2023.08 legacy plan), Enterprise Scale |
Error responses
Not admin (403)
Only an admin can perform this action.
{"error": {"message": "You are not permitted to perform this operation","type": "INVALID_PERMISSIONS"}}
Request (example)
Copy
$curl -X DELETE "https://api.airtable.com/v0/meta/bases/{baseId}" \-H "Authorization: Bearer YOUR_TOKEN"
200 – Response (example)
{"deleted": true,"id": "appLkNDICXNqxSDhG"}