Web API

Press shift + S to search API reference.

Workspaces

Delete base

deletehttps://api.airtable.com/v0/meta/bases/{baseId}

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.

Requirements

AuthenticationPersonal access token, OAuth integration
ScopeworkspacesAndBases: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 plansEnterprise (pre-2023.08 legacy plan), Enterprise Scale

Path parameters

baseId
string

Response format

id
string

Base ID, a unique identifier for a base.

deleted
true

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"
}