Web API

Press shift + S to search API reference.

Workspaces

Delete workspace

deletehttps://api.airtable.com/v0/meta/workspaces/{workspaceId}

Deletes the specified workspace.

Deleted workspaces can be restored by workspace owners from the Trash UI, up to the workspace's billing plan retention period.

WARNING: If the API user is not currently a workspace owner (one example where this can happen is if the API user is an enterprise admin), the workspace will not show up in the user's Trash.

WARNING: Any bases in the deleted workspace will no longer be accessible, be sure to double check whether there are any actively used bases before proceeding with workspace deletion. If you want to retain access to these bases, you should transfer the bases to another workspace before deleting the workspace.

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

workspaceId
string

Response format

id
string
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/workspaces/{workspaceId}" \
-H "Authorization: Bearer YOUR_TOKEN"
200 – Response (example)
{
"deleted": true,
"id": "wspmhESAta6clCCwF"
}