Web API

Press shift + S to search API reference.

Workspaces

Move base

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

Move a base between two workspaces owned by the enterprise.

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

Request body

baseId
string

ID of the base to be moved

targetWorkspaceId
string

ID of the target workspace of the move. I.e. the workspace that the base will belong to once the move is complete. The target workspace must be in the same enterprise account as the source workspace.

targetIndex
optional<number>

The desired index for the base in the target workspace's base order (optional). If provided, targetIndex must be a number between 0 (beginning of the list) and the number of bases in the target workspace (end of the list). If targetIndex is not provided, the base will be moved to the end of the list of bases in the target workspace.

Response format

This endpoint returns an empty response on success.

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 POST "https://api.airtable.com/v0/meta/workspaces/{workspaceId}/moveBase" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"baseId": "appLkNDICXNqxSDhG",
"targetIndex": 0,
"targetWorkspaceId": "wspmhESAta6clCCwF"
}'